home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / ra_100.arc / RA.DOC < prev    next >
Text File  |  1991-02-16  |  232KB  |  6,773 lines
  1.  
  2.                 
  3.  
  4.  
  5.  
  6.  
  7.                                                                     
  8.                                
  9.                                                                     
  10.                                    
  11.                                                                     
  12.                                    
  13.                                                                     
  14.                                    
  15.                                                                     
  16.                                    
  17.                                                                     
  18.                                    
  19.          
  20.                                                                                
  21.                                                                                
  22.       ┌─────────┐┌───────┐ ┌────────────┐┌──────────┬───────────┬───────┐
  23.       │  ┌───┐  ││   ┌───┘ │  ┌─┐  ┌─┐  ││  ┌───┐   ├────┐  ┌───┤   ┌───┘
  24.       │  │   │  ││   └───┐ │  │ │  │ │  ││  │   │   │    │  │   │   └───┐
  25.       │  └───┘  └┤   ┌───┘ │  │ │  │ │  └┤  │   │   └┐   │  └┐  │   ┌───┘
  26.       │  ┌────┐  │   └─────┤  │ │  │ │   │  └───┘    │   │   │  │   └─────┐
  27.       │  │    │  │         │  │ │  │ │   │           │   │   │  │         │
  28.       └──┘    └──┴─────────┴──┘ └──┘ └───┴───────────┘   └───┘  └─────────┘
  29.         
  30.                                                                                
  31.            ┌──────────┬──────┐ ┌──────┐ ┌───────┐ ┌───────┐ ┌───────┐
  32.            │  ┌───┐   │   ┌──┘ │   ┌──┘ │   ┌───┘ │   ┌───┘ │   ┌───┘
  33.            │  │   │   │   │    │   │    │   └───┐ │   └─────┤   └─────┐
  34.            │  └───┘   │   │    │   │    │   ┌───┘ └─────┐   ├─────┐   │
  35.            │  ┌────┐  │   └────┤   └────┤   └─────┬─────┘   ├─────┘   │
  36.            │  │    │  │        │        │         │         │         │
  37.            └──┘    └──┴────────┴────────┴─────────┴─────────┴─────────┘
  38.             
  39.                                                          
  40.                                                                                
  41.   
  42.                                   RemoteAccess v1.00 
  43.  
  44.                   
  45.                                      (C) 1989-91 
  46.              
  47.             Andrew Milner and Continental Software, All Rights Reserved
  48.              
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.        TABLE OF CONTENTS
  64.        ────────────────────────────────────────────────────────────
  65.  
  66.        PREAMBLE AND CREDITS  . . . . . . . . . . . . . . . . .    2
  67.  
  68.        OVERVIEW AND FEATURES . . . . . . . . . . . . . . . . .    3
  69.  
  70.        LICENSING INFORMATION . . . . . . . . . . . . . . . . .    5
  71.  
  72.        HOW TO REGISTER . . . . . . . . . . . . . . . . . . . .    6
  73.             REGISTRATION FORM  . . . . . . . . . . . . . . . .    8
  74.             The key system . . . . . . . . . . . . . . . . . .    9
  75.  
  76.        PRODUCT SUPPORT . . . . . . . . . . . . . . . . . . . .   10
  77.             AUSTRALIA  . . . . . . . . . . . . . . . . . . . .   10
  78.             USA and CANADA . . . . . . . . . . . . . . . . . .   10
  79.             EUROPE . . . . . . . . . . . . . . . . . . . . . .   11
  80.  
  81.        INSTALLATION  . . . . . . . . . . . . . . . . . . . . .   12
  82.  
  83.        CONFIGURATION . . . . . . . . . . . . . . . . . . . . .   13
  84.             QuickBBS to RemoteAccess . . . . . . . . . . . . .   13
  85.             RACONFIG . . . . . . . . . . . . . . . . . . . . .   14
  86.                  Modem . . . . . . . . . . . . . . . . . . . .   14
  87.                  Other (miscellaneous) . . . . . . . . . . . .   17
  88.                  Events  . . . . . . . . . . . . . . . . . . .   23
  89.                  Files . . . . . . . . . . . . . . . . . . . .   24
  90.                  Messages  . . . . . . . . . . . . . . . . . .   29
  91.  
  92.        SECURITY  . . . . . . . . . . . . . . . . . . . . . . .   33
  93.  
  94.        MENUS . . . . . . . . . . . . . . . . . . . . . . . . .   34
  95.             Menu functions . . . . . . . . . . . . . . . . . .   35
  96.             Automatic command execution  . . . . . . . . . . .   59
  97.             Special optional data switches . . . . . . . . . .   59
  98.             Menu templates . . . . . . . . . . . . . . . . . .   60
  99.             The global menu  . . . . . . . . . . . . . . . . .   61
  100.             Setting up your menus  . . . . . . . . . . . . . .   62
  101.             Creating your menus - RAMENU . . . . . . . . . . .   63
  102.  
  103.        EXTERNAL SUPPORT FILES  . . . . . . . . . . . . . . . .   65
  104.             BADFILES.CTL . . . . . . . . . . . . . . . . . . .   68
  105.             FILES.CTL  . . . . . . . . . . . . . . . . . . . .   68
  106.             LIMITS.CTL . . . . . . . . . . . . . . . . . . . .   69
  107.             NAMES.RA . . . . . . . . . . . . . . . . . . . . .   70
  108.             PHONENUM.CTL . . . . . . . . . . . . . . . . . . .   70
  109.             PWDTRASH.CTL . . . . . . . . . . . . . . . . . . .   71
  110.             TRASHCAN.CTL . . . . . . . . . . . . . . . . . . .   71
  111.  
  112.        THE USER DATABASE . . . . . . . . . . . . . . . . . . .   72
  113.             Information stored in the user database  . . . . .   73
  114.             Packing and sorting the user file  . . . . . . . .   74
  115.  
  116.        THE MESSAGE DATABASE  . . . . . . . . . . . . . . . . .   75
  117.             Message database size limitations  . . . . . . . .   75
  118.             RAMSG Command summary  . . . . . . . . . . . . . .   76
  119.  
  120.        MAIL NETWORKING . . . . . . . . . . . . . . . . . . . .   80
  121.             Installing the nodelist files  . . . . . . . . . .   83
  122.  
  123.        MULTI - NODE OPERATION  . . . . . . . . . . . . . . . .   85
  124.        REFERENCE SECTION . . . . . . . . . . . . . . . . . . .   88
  125.             Sysop keys . . . . . . . . . . . . . . . . . . . .   88
  126.             Command-line parameters  . . . . . . . . . . . . .   90
  127.             Errorlevels  . . . . . . . . . . . . . . . . . . .   92
  128.             Text file control codes  . . . . . . . . . . . . .   93
  129.                  User Parameter Codes  . . . . . . . . . . . .   95
  130.                  System Parameter Codes  . . . . . . . . . . .   96
  131.             Modem string translation . . . . . . . . . . . . .   97
  132.             Questionnaire script language  . . . . . . . . . .   98
  133.             Terminal emulations  . . . . . . . . . . . . . .    103
  134.             Text file naming conventions . . . . . . . . . .    104
  135.             Interactive EMSI . . . . . . . . . . . . . . . .    105
  136.  
  137.        BATCH FILE EXAMPLES . . . . . . . . . . . . . . . . .    106
  138.             RemoteAccess stand-alone . . . . . . . . . . . .    106
  139.             RemoteAccess with a mailer . . . . . . . . . . .    107
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.        The  following  products and names are the copyrighted 
  186.        material  and  or  trademarks  of  their  copyright  and  or
  187.        trademark holders respectively:
  188.  
  189.  
  190.        QuickBBS,                
  191.        Echogen & QEcho          The QuickBBS Group, Inc.
  192.        DESQview                 Quarterdeck Systems
  193.        DoubleDOS                SoftLogic Systems  
  194.        TradeWars                Chris Sherrick
  195.        Opus                     Wynn Wagner III
  196.        TosScan & FrontDoor      Joaquim H. Homrighausen
  197.        BinkleyTerm              Bit Bucket Software
  198.        ZmailH                   Claude N. Warren
  199.        FidoNet                  Tom Jennings
  200.        IBM                      International Business Machines
  201.        ParaNet                  ParaNet Information Systems
  202.        MS-DOS                   Microsoft Corporation
  203.        X00                      Ray Gwinn
  204.        BNU                      David Nugent
  205.        Turbo Pascal             Borland International
  206.        TinyTerm                 Adam Stanislav
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.                                      1
  246.        PREAMBLE AND CREDITS
  247.        ────────────────────────────────────────────────────────────
  248.  
  249.        Firstly,  let me say that RemoteAccess was very much a  team
  250.        effort.  I  had  been running my bulletin board for about  a
  251.        year,  it was getting pretty busy so I put on a second line.
  252.        The  software I was using was QuickBBS,  so I did a heap  of
  253.        work trying to get it running both lines.  For the most part
  254.        it worked,  but it was very clumsy. I was complaining to Bob
  255.        Fletcher,  a sysop in Victoria, about it one night, and  Bob
  256.        said  something  like "Well,  YOU could always have a go  at
  257.        something better!" So the basic concept was born.  An  "all-
  258.        singing,  all-dancing"  BBS package that would run  multiple
  259.        lines  and  occupy as little memory as possible.  "Piece  of
  260.        cake!" I thought.  In my spare time I started playing around
  261.        with a couple of file-displaying utilities written in  Turbo
  262.        Pascal  5  (which  I had just bought,  and  was  anxious  to
  263.        learn.)
  264.  
  265.        Enter  Phil.  Someone mentioned that "some bloke called Phil
  266.        Mackay" was writing a toolbox of routines to manipulate  the
  267.        QuickBBS  message and user database files so I dropped him a
  268.        message.  Phil was immediately taken by the idea and sent me
  269.        the source to what he had written.  I was impressed.  As  it
  270.        happened,  Bob was in Perth at this time and during a couple
  271.        of  brainstorming  sessions helped to refine what I  already
  272.        had (which wasn't much).
  273.  
  274.        Gradually I started to spend more and more of my spare  time
  275.        working  on  it,  and I started to realise the scale of  the
  276.        project (which still kinda frightens me).  I realised  there
  277.        was no way I could do it all myself,  so I enlisted the help
  278.        of  one or two other people to write utilities,  and "farmed
  279.        out" a fair bit of coding to Phil.  All the following people
  280.        deserve recognition for their contributions:
  281.  
  282.        Phil  Mackay - all the high and low-level  message  database
  283.        routines,   the  menu  editor  and  an  infinite  number  of
  284.        suggestions,  not  to  mention  invaluable  advice  on  many
  285.        occasions.
  286.  
  287.        David  Nugent - Wrote the message-base  maintenance  utility
  288.        "RAMSG",  was  ALWAYS ready to provide answers to  any  low-
  289.        level  communications  problem,  and wrote the  multitasker-
  290.        aware code.
  291.  
  292.        Adam  Blake  - Did the configuration utility "RACONFIG"  and
  293.        changed  it  twice a day when I made more mods to  the  main
  294.        program, uncomplainingly. (Well, almost).
  295.  
  296.        The  beta  test team - thanks guys!  Couldn't have  done  it
  297.        without ya.  Too numerous to list here, all the current beta
  298.        systems   are  listed  in  the  accompanying  document   RA-
  299.        BETAS.DOC.
  300.  
  301.                                           Andrew Milner.   
  302.                                           Perth, Western Australia.
  303.                                           ─────────────────────────
  304.  
  305.  
  306.                                      2
  307.        OVERVIEW AND FEATURES
  308.        ────────────────────────────────────────────────────────────
  309.  
  310.        RemoteAccess   is  a  "fully-blown"  remote  bulletin  board
  311.        package.  It  may be used as a stand-alone system or with  a
  312.        front-end  mailer  if  you wish to interface it  to  a  mail
  313.        network  such as FidoNet.  It offers fully  definable  menus
  314.        with  a  unique  template system which provides not  only  a
  315.        massive  degree  of  flexibility in  making  your  BBS  look
  316.        different  from  any  other,  but also the  lowest  possible
  317.        maintenance.  AVATAR  screen  control  is built  in,  making
  318.        possible extremely efficient and  complex colour and  cursor
  319.        control at the user's  end if an AVATAR terminal  program is
  320.        used.
  321.  
  322.        Access  to the 200 available message areas is controlled  by
  323.        your  menu structure,  along with a  sophisticated  security
  324.        system which incorporates over 64,000 security levels with a
  325.        set of user-definable flags. For each security level you can
  326.        specify maximum download limits for different log-on speeds,
  327.        daily time limits, and optionally activate the built-in file
  328.        ratio  system,  limiting  downloads by ratio to  uploads  by
  329.        either  number  of  files  or kilobytes.  In  addition  it's
  330.        possible to assign a user to one of 255 separate groups, and
  331.        in so doing segregate groups of users from each other.
  332.  
  333.        Other security features include the disallowing of downloads
  334.        during peak hours,  disallowing low speed callers at certain
  335.        times,  and disallowing ANSI graphics at low speeds. You can
  336.        disallow  one-word "pseudonyms",  and  optionally  configure
  337.        the system to force a user to change passwords every x  log-
  338.        ons. Undesirable user names and passwords are also definable
  339.        for  maximum  security.  If you're unlikely to want to  call
  340.        your own system, remote sysop access can be disabled, making
  341.        it virtually impossible for your account to be "hacked".
  342.  
  343.        Direct  support  for high-speed modems up to 38,400 baud  is
  344.        available, and RemoteAccess will optionally answer the phone
  345.        automatically  to ensure that the modem will answer if  your
  346.        BBS is "alive and well".
  347.  
  348.        RemoteAccess  supports as many as 99  lines  simultaneously.
  349.        Full  system  access  to  all  file  and  message  areas  is
  350.        available  to  each line (at your discretion),  as  are  all
  351.        doors.  Several  "multi-node specific" features are provided
  352.        to  augment  multi-line operation.  You  can  configure  the
  353.        system  to  disallow one person logging on to more than  one
  354.        line  at  a  time.  A "who else is  on-line?"  and  "today's
  355.        callers" function is available to you,  along with  separate
  356.        system  logs  for each line.  Logging is selectable  between
  357.        either  Opus  or  FrontDoor styles  to  aid  integrated  log
  358.        readability.   Some  basic  user-to-user  on-line messaging,
  359.        to be expanded at a later date, is also available.
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.                                      3
  368.        RemoteAccess does NOT do its own internal multi-tasking.  To
  369.        this  end,  we have attempted to make it as well-behaved  as
  370.        possible.  It  has built-in time-slicing and screen-handling
  371.        support  for  DESQview,  TopView,  MultiLink,  DoubleDOS and
  372.        PC-MOS/386. It is  fully overlaid and occupies approximately
  373.        190k of memory when fired up. What do you do if you have say
  374.        a 300k DESQview window and want to run TradeWars in a shell?
  375.        No problem!  Simply by specifying a control character on the
  376.        command line,  you can instruct RemoteAccess to swap  itself
  377.        lock,  stock  and barrel to EMS and/or disk leaving only 20k
  378.        resident. 
  379.  
  380.        A  comprehensive  file transfer system is also part  of  the
  381.        package.  Six  of  the  most  popular  protocols,  including
  382.        Zmodem,  Ymodem batch and Xmodem are built-in,  and  fifteen
  383.        slots  for  external protocols are available for you to  add
  384.        any   others.  All  protocols may  be made  available on  an
  385.        "error  free"  connect basis  at  the  your discretion.  The
  386.        protocol interface   system   is  extremely  flexible,   and
  387.        has   been tested  with DSZ,   Kermit  (an  Opus  compatible
  388.        protocol),   and BiModem. There are of course many others we
  389.        haven't tested, but most should work. Support for CD-ROM and
  390.        other mass  read-only media  is another  invaluable feature.
  391.        The  file   transfer   system   is   further   enhanced   by
  392.        comprehensive file search  and locate  functions along  with
  393.        the ability to tag any file  or group of files as "free" and
  394.        or password protected. A large selection of transfer options
  395.        include global downloads and  the ability for specific files
  396.        to be attached to a file transfer menu option.
  397.  
  398.        Interactive EMSI  session support  is an exciting  new first
  399.        for RemoteAccess! Read the section on IEMSI in the reference
  400.        section  at the  end of  this document  for details  on this
  401.        revolutionary new set of features.
  402.  
  403.        Extensive on-line facilities are available to the sysop.  An
  404.        optional set of status bars provide a wealth of  information
  405.        about  both  the  person currently on-line and  the  system.
  406.        Several  "hot-keys"  are also available to  perform  a  wide
  407.        range  of functions,  amongst which  is a  full  screen user
  408.        attribute  editor, a "sysop on next" key, shell to DOS, hang
  409.        up, lock out, and local snoop.
  410.  
  411.        As an added bonus, we have decided to use the QuickBBS-style
  412.        user  and message database formats.  This means that you can
  413.        continue  to use your favourite QuickBBS utilities  with  no
  414.        need to convert to another format.  Any incompatibilities in
  415.        the  configuration  files  is taken care of  by  an  upgrade
  416.        utility.  We  make  no  apology for the  similarity  between
  417.        RemoteAccess and QuickBBS.  QuickBBS had many features  that
  418.        we  wanted,  and  compatibility  gives the  added  bonus  of
  419.        offering  the  sysop  ease  of  installation  and a familiar
  420.        environment.
  421.  
  422.        To  cater for both Opus and QuickBBS users alike,  each user
  423.        has  (at  the discretion of the sysop) the option  of  using
  424.        hot-keyed   menus   or   command   stacking.   Comprehensive
  425.        messaging, file search  options and support for a wide range
  426.        of "doors" ensure that your BBS will be a hit!
  427.  
  428.                                      4
  429.        LICENSING INFORMATION
  430.        ────────────────────────────────────────────────────────────
  431.  
  432.        "RA"  refers  to the executable programs  and  documentation
  433.        contained    in   RemoteAccess   Bulletin   Board   Software
  434.        distribution archives released by Continental Software.
  435.  
  436.        1.  RA  is the copyrighted material of Continental Software.
  437.        It  may only be used  in accordance with  the conditions set
  438.        out in this license agreement.
  439.  
  440.        2.  You  may  use RA for a period of three weeks on a  trial
  441.        basis  in  order  to determine  it's  suitability  for  your
  442.        particular application.  After this period you MUST register
  443.        each  copy  of RA that you  run  simultaneously.  Multi-line
  444.        installations  that share  a common file  base AND  have the
  445.        same name need only register one copy.
  446.  
  447.        3.  Registration  entitles  you to  use  RA  and any  future
  448.        versions of  RA  for  as long as you wish,  subject  to  any
  449.        special  licensing conditions  attached to  future versions.
  450.        For  details on  the  registration procedure,  refer to  the
  451.        section in this document "HOW TO REGISTER".
  452.                     
  453.        4.  Continental  Software   is   in  no   way   obligated to
  454.        provide future versions of, or support for, RA.   
  455.  
  456.        5. Site and Group registrations are available, and are dealt
  457.        with on a case by case basis.
  458.  
  459.        6.  You  may  not  modify or otherwise  reverse-engineer RA.
  460.  
  461.        7.  You are encouraged to distribute RA provided that no fee
  462.        is charged  for its distribution, and  that the distribution
  463.        archive  is not  modified  in any  way.  Pay Bulletin  Board
  464.        Systems  may however charge  their  normal fee provided that
  465.        no additional charge for RA is levied.  
  466.  
  467.        8. RA  may not be  included as part of  any software library
  468.        which  is distributed  on a  commercial basis  (commercial =
  469.        "for   money")  without   prior   written  permission   from
  470.        Continental Software.
  471.  
  472.        9. RA may not be used in any unlawful or illegal manner.
  473.  
  474.        10.  Continental  Software's liability  resulting from  your
  475.        use or   inability   to use  RemoteAccess is limited  to the
  476.        amount that  the affected party has  paid for it, or  in the
  477.        event  that RA was registered with a third party for payment
  478.        to Continental Software, liability  is limited to the amount
  479.        that was  received by  Continental Software from  that third
  480.        party.
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.                                      5
  490.        HOW TO REGISTER
  491.        ────────────────────────────────────────────────────────────
  492.  
  493.        Print  or reproduce the registration form at the end of this
  494.        section and send it with your registration payment to one of
  495.        the following sites:
  496.  
  497.  
  498.        AUSTRALIA:
  499.  
  500.             "Registration/RA"             "Registration/RA"
  501.             Continental Software          Box 10 
  502.             C/- Milner Intl College       312b North Rocks Rd
  503.             195 Adelaide Terrace          North Rocks  2151
  504.             Perth  6000                   NSW AUSTRALIA
  505.             WESTERN AUSTRALIA
  506.  
  507.  
  508.        EUROPE:                           USA:
  509.  
  510.             "Registration/RA"             "Registration/RA"
  511.             C/- R.A. de Bruin             C/- Ed Meloan       
  512.             Columbusrede 17               1110 Terrace Circle Drive
  513.             2725 KL Zoetermeer            North Augusta SC 29841
  514.             HOLLAND                  
  515.  
  516.  
  517.        CANADA:
  518.  
  519.             "Registration/RA"
  520.             C/- Royce Jones  
  521.             624 Dolph Street N. Apt. #B
  522.             Cambridge ON    
  523.             CANADA N3H-2B4
  524.  
  525.  
  526.        NOTES:
  527.  
  528.        * You MUST fill out the registration form correctly in order
  529.          for your details to be processed. Not doing so will result
  530.          in delays in your key arriving.
  531.  
  532.        * Cheques  and   money   orders  should  be  made  payable  
  533.          to Continental Software UNLESS you are registering in the 
  534.          USA, Canada or Europe. USA residents should make cheques  
  535.          payable to Ed Meloan; Canadian cheques should be made     
  536.          payable to Royce Jones, and cheques sent to the European  
  537.          registration site should be made payable to R.A. de Bruin.
  538.         
  539.        * Please include either a FidoNet address or a stamped,     
  540.          self-addressed  envelope  so that receipt of your payment 
  541.          can  be acknowledged.
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.                                      6
  551.        * All COMMERCIAL U.S. enquiries should be made to:
  552.  
  553.             Richard Brannon
  554.             PowerNet
  555.             625 Greencove Terrace
  556.             #128 Altamonte Springs
  557.             FLORIDA 32714
  558.             (407) 788 3736
  559.  
  560.  
  561.  
  562.        REGISTRATION FEES: Simply use the denomination that is      
  563.                           accepted by the registration site which  
  564.                           covers your area.
  565.  
  566.  
  567.             Noncommercial : $AUD60, $US50, $CDN60, DFL120
  568.             Systems that qualify for this category must be         
  569.             physically run from a noncommercial site. A site is    
  570.             considered to be noncommercial only if it is a private 
  571.             residence at which no commercial activities are        
  572.             conducted.
  573.  
  574.             Commercial/1  : $AUD150, $US120, $CDN150, DFL280
  575.             If the system is physically run from a commercial site 
  576.             (ie. the site is not a private residence, or commercial
  577.             activities are conducted at the site), but does not    
  578.             generate revenue as part of the PRIMARY commercial     
  579.             activities conducted at that site.
  580.  
  581.             Commercial/2  : $AUD350, $US265, $CDN350, DFL625
  582.             If the system generates revenue as part of the         
  583.             primary commercial activities conducted at the system  
  584.             site.
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.                                      7
  612.                   *** RemoteAccess REGISTRATION FORM ***
  613.  
  614.  
  615.        Sysop Name _________________________________________________
  616.  
  617.        System Name ________________________________________________
  618.  
  619.        [The above two items are used to generate your registration 
  620.         key and must appear EXACTLY as they do in RACONFIG.]
  621.  
  622.  
  623.        Network Address (number and network name) __________________
  624.  
  625.  
  626.        Any other networks you are a member of _____________________
  627.  
  628.  
  629.        Primary BBS telephone number and baud ______________________
  630.  
  631.  
  632.        Voice telephone number _____________________________________
  633.  
  634.  
  635.        Hours of BBS operation _____________________________________
  636.  
  637.  
  638.        Postal Address :
  639.  
  640.        ____________________________________________________________
  641.  
  642.        ____________________________________________________________
  643.  
  644.        ____________________________________________________________
  645.  
  646.  
  647.  
  648.        Version of RemoteAccess registering ______.
  649.  
  650.  
  651.        Registration amount enclosed _______, for ____ copies.
  652.  
  653.  
  654.        What do you like about RemoteAccess?
  655.  
  656.        ____________________________________________________________
  657.  
  658.        ____________________________________________________________
  659.  
  660.        ____________________________________________________________
  661.  
  662.  
  663.  
  664.        What enhancements/changes  would you like to see in our next
  665.        release?
  666.  
  667.        ____________________________________________________________
  668.  
  669.        ____________________________________________________________
  670.  
  671.  
  672.                                      8
  673.        The key system
  674.        ────────────────────────────────────────────────────────────
  675.  
  676.        Upon registering you  will receive  your uniquely  generated
  677.        key. Each key is a small file approximately 2k in size which
  678.        contains information about your registration. To install the
  679.        key, simply rename it  (if necessary) to RA.KEY and  copy it
  680.        to your RemoteAccess system directory.
  681.  
  682.        When  RemoteAccess  detects a  valid  key  it switches  into
  683.        registered mode, identifying itself by placing a "+"  at the
  684.        end of the version number as well as displaying the  name of
  685.        the system and  sysop it  is registered to  in the  "version
  686.        information" menu function.
  687.  
  688.        For  example, logging  on to a  registered system  you would
  689.        see:
  690.  
  691.        RemoteAccess 1.00+
  692.        Please enter your full name:
  693.  
  694.        Features marked in this manual with a {+} are only available
  695.        when RemoteAccess is running in registered mode. These bonus
  696.        features  show our appreciation  of your taking  the time to
  697.        register with us.
  698.  
  699.        It  should be  made  absolutely clear  that RemoteAccess  is
  700.        still fully  functional before  it is registered;  the bonus
  701.        features are  "nice" but their  absence makes the  system no
  702.        less  usable.   RemoteAccess  is  not  and   never  will  be
  703.        "DemoWare" or "ExpireWare".
  704.  
  705.        WARNING!  Your key  is  unique, and  under NO  circumstances
  706.        should it be  made available to  anyone else. Doing so  is a
  707.        direct violation of the  agreement you entered into with  us
  708.        by registering.
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.                                      9
  734.        PRODUCT SUPPORT                    
  735.        ────────────────────────────────────────────────────────────
  736.  
  737.        You  can always  get the latest version of  RemoteAccess and
  738.        technical support from the following systems:
  739.  
  740.  
  741.  
  742.        AUSTRALIA:
  743.  
  744.             Andrew Milner                      Phil Mackay
  745.             RemoteAccess HQ                    RemoteAccess HQ East
  746.             Perth WA                           Sydney NSW
  747.             +61 9 389 8048 V32/HST             +61 2 872 6159
  748.             FidoNet@3:690/625                  FidoNet@3:711/801
  749.                 
  750.  
  751.  
  752.        USA and CANADA: (North American RemoteAccess Support group)
  753.  
  754.             Bruce Bodger                       Fred Horner   
  755.             The TruckStop BBS                  The Private EaR     
  756.             Tulsa OK                           Waco TX
  757.             918 254 6618 HST                   817 776 9877 HST
  758.             FidoNet@1:170/400                  FidoNet@1:388/10
  759.  
  760.             Mike Janke                         Ed Meloan
  761.             Kendall BBS                        Augusta Forum
  762.             Miami FL                           N. Augusta SC
  763.             305 271 2146 HST                   803 279 4124 HST
  764.             FidoNet@1:134/104                  FidoNet@1:360/1
  765.  
  766.             Al Bruner                          Royce Jones
  767.             The SW/SE Connection               DAKIN BBS
  768.             San Diego CA                       Cambridge Ontario
  769.             619 467 0335 HST                   519 653 7677 HST    
  770.             FidoNet@1:202/707                  FidoNet@1:221/204
  771.  
  772.             Mark Howard                        Jamie Penner
  773.             Rivendell                          SIGnet Netlink    
  774.             Syracuse NY                        Burnaby BC
  775.             315 458 8602 HST                   604 421 1721 HST
  776.             FidoNet@1:260/340                  FidoNet@1:153/169
  777.  
  778.             Jim Roe
  779.             Middle Earth
  780.             Austin TX
  781.             512 835 4848 HST
  782.             FidoNet@1:382/19
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.                                     10
  795.        EUROPE:
  796.  
  797.             John Barton                        Malte Erikson
  798.             European Support Coordinator       SWEDEN
  799.             UNITED KINGDOM                     +46 300 29436 
  800.             +44 708 670068 HST                 FidoNet@2:203/302
  801.             FidoNet@2:257/168                  
  802.  
  803.             Ruud de Bruin                      Stefano Pasquino
  804.             HOLLAND                            ITALY
  805.             +31 79 424553 V32                  +39 766 540899
  806.             FidoNet@2:281/603                  FidoNet@2:335/5
  807.  
  808.             Joerg Dassler                      Benoit De.Guffroy
  809.             GERMANY                            BELGIUM
  810.             +49 9132 9145 HST                  +32 51 241352
  811.             FidoNet@2:509/6                    FidoNet@2:285/56
  812.  
  813.             Robert Maierhofer                  Hilmar Thors
  814.             AUSTRIA                            ICELAND
  815.             +43 1 390545                       +354 1 77568
  816.             FidoNet@2:310/19                   FidoNet@2:257/3000
  817.  
  818.             Lars Erikssons                     Kalin Krustanov
  819.             FINLAND                            BULGARIA
  820.             +35 828 23452                      +359 2 8672082
  821.             FidoNet@2:515/450                  FidoNet@2:359/103
  822.  
  823.             Robert Sorbie
  824.             FRANCE
  825.             +33 568 95112
  826.             FidoNet@2:324/1
  827.  
  828.  
  829.  
  830.        There  is  also an echomail  support  conference  available,
  831.        called RA_SUPPORT to answer all of your questions. 
  832.  
  833.        New  releases  and the RA_SUPPORT conference should also  be
  834.        available  from any of the beta test sites,  listed  in  the
  835.        accompanying document RA-BETAS.DOC.
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                                     11
  856.        INSTALLATION
  857.        ────────────────────────────────────────────────────────────
  858.  
  859.        RemoteAccess   should  run  on  any  IBM  80x86   compatible
  860.        computer. The only two programs you will need in addition to
  861.        the  release  package are DOS 3.x and a FOSSIL  driver.  The
  862.        FOSSIL is a memory-resident program that many communications
  863.        packages use to communicate with the modem. Two FOSSILs that
  864.        have  been  successfully tested with  RemoteAccess  are  Ray
  865.        Gwinn's X00,  and David Nugent's BNU. Either of these should
  866.        be readily available from any local bulletin board.
  867.  
  868.        You  will  also  need a modem that is capable  of  accepting
  869.        Hayes-type  commands.  The  minimum  memory  requirement  is
  870.        approximately 190K, but 512K is recommended.
  871.  
  872.             1.  Ensure  that  your CONFIG.SYS file  contains  these
  873.                 statements:
  874.  
  875.                 FILES=20
  876.                 BUFFERS=25
  877.                      
  878.                 The   more  buffers  you   allocate,   the   faster
  879.                 RemoteAccess  will run.  However,  more buffers use
  880.                 more memory.
  881.  
  882.             2.  Create  a directory to put the main program  files 
  883.                 in.  The  configuration example that follows  later
  884.                 assumes that this directory (the SYSTEM  directory)
  885.                 is C:\RA.
  886.  
  887.             3.  Ensure  that  your  AUTOEXEC.BAT  file  contains  a
  888.                 command to set the environment variable RA to  your
  889.                 SYSTEM  directory,  so  RemoteAccess can  find  its
  890.                 configuration files:
  891.  
  892.                       SET RA=C:\RA
  893.  
  894.             4.  Copy   all  of  the  executable  files  from  the 
  895.                 RemoteAccess   distribution   package   into   this
  896.                 directory. 
  897.                     
  898.             5.  Create three more sub-directories:
  899.  
  900.                 C:\RA\MSGBASE          This will hold  the  message
  901.                                        files the system creates.
  902.  
  903.                 C:\RA\MENUS            To put your menus in,
  904.  
  905.                 C:\RA\TXTFILES         To put files such as welcome
  906.                                        and disconnect screens in.
  907.  
  908.        You   are   now   ready  to  proceed  to  the   next   step,
  909.        CONFIGURATION.
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.                                     12
  917.        CONFIGURATION                              
  918.        ────────────────────────────────────────────────────────────
  919.  
  920.        If  you are upgrading your system from a  presently-existing
  921.        QuickBBS  system,  then read the next paragraph.  If  you're
  922.        installing  RemoteAccess  from  scratch  then  skip  to  the
  923.        section on RACONFIG.
  924.  
  925.  
  926.        QuickBBS  to RemoteAccess                                   
  927.        ────────────────────────────────────────────────────────────
  928.  
  929.        A utility,  called QTORA.EXE has been provided to allow  you
  930.        to convert your existing QuickBBS configuration files to the
  931.        RemoteAccess  format.  Note  that  it will not  modify  your
  932.        existing configuration files in any way.  Copy QTORA to your
  933.        QuickBBS  system directory and run it.  It will  prompt  you
  934.        through  the  whole  conversion process,  and  when  it  has
  935.        finished,  copy  all  the  files  it  has  created  to  your
  936.        RemoteAccess system directory:
  937.  
  938.             COPY *.RA C:\RA
  939.  
  940.        Now,  copy all the *.CTL files to your  RemoteAccess  system
  941.        directory:
  942.  
  943.             COPY *.CTL \RA
  944.  
  945.        The  final  step is to copy all of your BBS system files  to
  946.        the  RemoteAccess  directories.  Copy all the message  files
  947.        (MSG*.BBS)  and the user files (USERS.BBS and  LASTREAD.BBS)
  948.        to the message base directory, and all the other *.BBS files
  949.        to the system directory.
  950.  
  951.        The  conversion process is now complete,  and you can delete
  952.        QTORA.EXE, as it will not be needed for anything else.
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.                                     13
  978.        RACONFIG            
  979.        ────────────────────────────────────────────────────────────
  980.  
  981.        Return to the RemoteAccess system directory again,  and fire
  982.        up  the configuration utility,  RACONFIG.EXE.  You will  use
  983.        this to choose the configuration options for your particular
  984.        system.  You will see that there are six options in the menu
  985.        bar. Here is a walk-through of the various options.
  986.  
  987.  
  988.  
  989.        Modem
  990.        ────────────────────────────────────────────────────────────
  991.  
  992.        Select  the  MODEM  option,  and  then  SETUP.  This  window
  993.        contains  general configuration information for your  modem.
  994.  
  995.        The  first  item  is the COMPORT setting.  Set this  to  the
  996.        communications port you have your modem hooked up to.  Valid
  997.        ports  are 1-4.  MAXIMUM BAUD refers to the  highest  modem-
  998.        computer speed your modem supports. If you are using a high-
  999.        speed modem you should lock the speed at the modem's maximum
  1000.        speed  to ensure the highest possible throughput.  Refer  to
  1001.        your FOSSIL documentation on how to do this.
  1002.  
  1003.        The  INITIALISATION  RESPONSE is the string that  the  modem
  1004.        returns  after  RemoteAccess  sends  it  the  initialisation
  1005.        string.  Most  modems  return "OK".  Likewise for  the  BUSY
  1006.        RESPONSE,  most modems  also return  "OK". Check  your modem
  1007.        operating manual for more information.
  1008.  
  1009.        The  RING  STRING  is  the string the  modem  displays  when
  1010.        someone calls your system,  to indicate that the call should
  1011.        be answered.  Most modems return "RING", some use "RINGING".
  1012.        Check your modem manual and set this accordingly.
  1013.  
  1014.        ERROR FREE CONNECT is  the response your modem  returns when
  1015.        it gets an MNP  connection. Ignore this entry if  your modem
  1016.        doesn't support  MNP. Check  your modem manual  to determine
  1017.        what string your modem returns.
  1018.  
  1019.        CONNECT 300 - CONNECT 38k are the response strings the modem
  1020.        returns when a connection is made with another  modem.  Most
  1021.        modems  return  a  "CONNECT <Baudrate>"  string,  or  simply
  1022.        "CONNECT"  for 300 baud.  Note that if this is the case  you
  1023.        should specify the vertical bar after the string to indicate
  1024.        the end of the string.  (See MODEM STRING TRANSLATION in the
  1025.        reference guide at the end of this document).
  1026.  
  1027.        AUTOMATIC ANSWER.  Setting this to "Yes" tells  RemoteAccess
  1028.        to  make the modem answer the phone whenever it receives the
  1029.        ring string by sending the answer command to the modem  (see
  1030.        INITIALISATION).  If  it  is set to "No" then it is  assumed
  1031.        that  the modem will answer the phone itself.  "Yes" is  the
  1032.        preferred  setting,  as it ensures that your BBS  will  only
  1033.        answer the phone if it is "alive and well".  Otherwise,  you
  1034.        are likely to upset your users when they  waste their  money
  1035.        on a BBS that answers the phone and then does nothing.
  1036.  
  1037.  
  1038.                                     14
  1039.        MODEM  DELAY refers to a delay,  in tenths of a second  that
  1040.        RemoteAccess  waits between sending characters to the  modem
  1041.        during initialisation.  Usually you will only need to  raise
  1042.        this  above  zero if you are using a high-speed  modem  that
  1043.        cannot handle commands at high speeds.  A typical example of
  1044.        this is the Courier HST, which requires a delay of about 3.
  1045.  
  1046.        The   OUTBOUND   BUFFER   SIZE  field  sets  the   size   of
  1047.        RemoteAccess'  internal communications send buffer for  baud
  1048.        rates up to 2400. You can change it to fine-tune your system
  1049.        for maximum throughput. If you are using a slow machine (ie.
  1050.        a 4.77 MHz XT),  set it to zero.  This disables the internal
  1051.        buffering  system  and its  associated  overhead.  For  most
  1052.        systems,  the  default  setting  of 5 will not  need  to  be
  1053.        changed.  In  a multi-tasking environment though,  you  will
  1054.        achieve  much  better performance by increasing  the  buffer
  1055.        size.  Experimentation  has shown values around 80-150 to be
  1056.        most effective.
  1057.  
  1058.        Some modems (such as  the Courier HST) can be  configured to
  1059.        clear  their internal  transmit buffer  when they  receive a
  1060.        break  signal from the local  console. If the  SEND BREAK TO
  1061.        CLEAR  option is  enabled,  RemoteAccess will  send a  break
  1062.        whenever it  purges it's  own internal transmit  buffer. The
  1063.        result will be a faster hotkey response.
  1064.  
  1065.  
  1066.        Now  select the INITIALISATION submenu. INITIALISATION TRIES
  1067.        is   the  number  of times  RemoteAccess  will attempt    to
  1068.        initialise the modem before aborting and returning an  error
  1069.        condition.
  1070.  
  1071.        The  INITIALISATION  STRING  is sent to the  modem  whenever
  1072.        RemoteAccess  is fired up.  This string should  prepare  the
  1073.        modem to take calls.  See the reference section MODEM STRING
  1074.        TRANSLATION   at   the  end  of  this  document   for   more
  1075.        information.
  1076.  
  1077.        The  BUSY  STRING is sent to the modem whenever  you  either
  1078.        log-on  locally  or if you ESCape from the "wait  for  call"
  1079.        sequence.  You  could either tell the modem to go "off hook"
  1080.        with  an  "ATH1|",  or  simply not to answer  the  phone  by
  1081.        dropping DTR.
  1082.  
  1083.        The  ANSWER  STRING  is sent to the modem if  you  have  set
  1084.        automatic answer on,  and a call comes in.  Most modems will
  1085.        answer a call upon receiving an "ATA|" from the computer.
  1086.  
  1087.  
  1088.        Next select the ERRORLEVELS submenu.   These values are used
  1089.        if  you have   activated  the  "Shell to   Mailer"  feature.
  1090.        For  full information   on this option,  read  the reference
  1091.        section  on COMMAND LINE PARAMETERS.
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.                                     15
  1100.        Select  the RESTRICTIONS  submenu.  MINIMUM BAUD  FOR  LOGON
  1101.        allows  you to set the lowest baud rate for a user to log on
  1102.        to your system. Calls at 300 baud may be restricted by using
  1103.        the  NO 300 START and NO 300 END options.  To  disable  this
  1104.        option, set both start and end times to 00:00.
  1105.  
  1106.        You can also limit file downloads in the same way.  However,
  1107.        this  option differs slightly in that the MINIMUM  BAUD  FOR
  1108.        FILE TRANSFERS applies all the time.  The DOWNLOAD START/END
  1109.        times  specify times during which downloads may occur.  Note
  1110.        that  this  time  restriction may be cancelled  for  certain
  1111.        users  by  setting  a flag in their  user  record.  See  the
  1112.        section on USERS for more on this.
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.                                     16
  1161.        Other (miscellaneous)
  1162.        ────────────────────────────────────────────────────────────
  1163.  
  1164.        Select the PATHS  menu.  Here  you   tell RemoteAccess where
  1165.        all its associated files  are stored.  The directories   are
  1166.        the  same as the ones discussed earlier  in the installation
  1167.        example.   Enter the  full  directory paths  to your  chosen
  1168.        directories. The trailing backslash is optional.
  1169.        See the section on MAIL NETWORKING for details on how to set
  1170.        up  the   NODELIST  path.  Check  the   section  on  message
  1171.        configuration  for details on the FILE  ATTACH PATH, and the
  1172.        section  on files configuration for details on the FILE LIST
  1173.        path.
  1174.  
  1175.  
  1176.        Select the ADDRESS  submenu.  If  you do  not intend to  use
  1177.        your BBS in a mail network (eg. FidoNet, AlterNet) then skip
  1178.        this  section.  Select MAIN ADDRESS and enter  your  network
  1179.        address. If you have any alias addresses (AKAs), enter these
  1180.        in  one  or  more  of the nine  slots  provided.  For  extra
  1181.        information  on  network  operation and  an  explanation  of
  1182.        addresses, see the section on MAIL NETWORKING.
  1183.  
  1184.  
  1185.        Now   select  the  NEW  USERS  submenu.  SECURITY    is  the
  1186.        security level (0 to 64,000) that  will be granted to  a new
  1187.        user  who   logs on for  the first time.   If  you   run   a
  1188.        private  system,  and do not want to allow new users to  log
  1189.        on,  set  this  field to zero.  In this case,  the  user  is
  1190.        notified that the system is private and is disconnected.
  1191.         
  1192.        The four flag entries  determine the flag configuration that
  1193.        will  be granted to new  users. See the  section on SECURITY
  1194.        for a full description of the RemoteAccess security system. 
  1195.  
  1196.        NETMAIL  CREDIT is  the  new user's  initial credit  against
  1197.        sending  netmail messages.  The NETWORKING  section provides
  1198.        full details on setting up netmail costings.
  1199.  
  1200.        GROUP NUMBER is an arbitrary number between zero and 255 you
  1201.        may  assign new users. It allows you to segregate users into
  1202.        separate groups.  Presently the  only support for  the group
  1203.        number exists in the  list users menu command (see  the menu
  1204.        command list for further details).
  1205.  
  1206.        The next four entries,  ANSI, AVATAR, CLEAR SCREEN  and MORE
  1207.        determine  how  these  attributes  are  set  in  the  user's
  1208.        permanent record.  Set to  "No" will force  the option  off;
  1209.        "Yes" forces the option on, and "Ask"  asks the new user for
  1210.        his/her preference for each setting.
  1211.  
  1212.        The  next two  options determine whether  new users  will be
  1213.        asked  for  their  data  and voice  telephone  numbers.  The
  1214.        numbers  are  checked  against  a definable  list  of  "bad"
  1215.        numbers. The EXTERNAL SUPPORT FILES section  has more on the
  1216.        PHONENUM.CTL file.
  1217.  
  1218.  
  1219.  
  1220.  
  1221.                                     17
  1222.        If  ALLOW  ONE WORD  NAMES is  disabled,  new users  will be
  1223.        required  to enter their name  as at least  two words with a
  1224.        total  length of at  least three characters.  Note that this
  1225.        restriction only applies to new users; a user already in the
  1226.        user database may log on using his or "handle".
  1227.  
  1228.        If the HANDLE option is enabled, new users will be asked  to
  1229.        choose  a an optional unique handle, or alias. THis is saved
  1230.        as part of the user's record and may be used to log onto the
  1231.        system  later, and to send and receive mail. More details on
  1232.        this are in the messages configuration section.
  1233.  
  1234.        If DATE OF BIRTH  is enabled, new users will  be prompted to
  1235.        enter  their full  birthdate. RemoteAccess  will attempt  to
  1236.        "intelligently" identify if the date supplied is legitimate.
  1237.  
  1238.        RemoteAccess   may  be  configured  to  behave  either  like
  1239.        QuickBBS  with hot-keyed menus,  or like Opus  with  command
  1240.        stacking  facilities.  If the USE HOT-KEYS option is set  to
  1241.        "Yes", the system defaults to hot keys for each new user. If
  1242.        the  option  is set to "Ask" then each new user is asked  to
  1243.        choose  between hot keys or command stacking.  The user  may
  1244.        change his or her choice by selecting the toggle hotkey menu
  1245.        command (see the section on MENU FUNCTIONS).
  1246.  
  1247.        The  FULL  SCREEN MSG  VIEWER,  when  enabled, will  display
  1248.        messages  to  the  user  using an  improved  "fixed  header"
  1249.        format, designed for enhanced readability.
  1250.  
  1251.        The final option  on the  new users submenu  is ALLOW  IEMSI
  1252.        SESSIONS.  When a  new user  connects to  your  system using
  1253.        IEMSI  (explained fully  in  the reference  section of  this
  1254.        manual),  RemoteAccess   will  skip  the  regular  new  user
  1255.        questionnaire   as  it  can   determine  the  user's  screen
  1256.        parameters, location,  password etc. automatically.  If this
  1257.        option  is disabled however, all new users will be forced to
  1258.        answer the regular questionnaire manually.
  1259.  
  1260.  
  1261.        The  COLOURS submenu  allows you  to costomise  some  of the
  1262.        more-often used colours that the user sees.
  1263.  
  1264.  
  1265.        Now go to the VIDEO submenu. You can force the system to run
  1266.        in Monochrome  Mode by setting MONOCHROME to "Yes".   If you
  1267.        are not using  RemoteAccess in a multi-tasking  environment,
  1268.        then set DIRECT  WRITE MODE to "Yes".   This will  cause all
  1269.        screen output  to  be written directly to Video  RAM instead
  1270.        of  using BIOS calls, and will result in a significant speed
  1271.        increase. If  you  use  one of the older CGA cards that   is
  1272.        prone  to "snowing", set SNOW CHECK to "Yes".
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.                                     18
  1283.        Select the USERS submenu.
  1284.  
  1285.        NUMBER  OF TIMES TO TRY FOR PASSWORD sets the maximum number
  1286.        of  invalid password attempts.  After this is  exceeded  the
  1287.        user will be disconnected.
  1288.  
  1289.        LOGONS  BEFORE  FORCED PASSWORD CHANGE is  another  security
  1290.        feature.  If  this  is set to any non-zero value,  then  all
  1291.        users  (excluding the sysop) will be forced to change  their
  1292.        password every number of logons as determined by its value.
  1293.  
  1294.        TIME  LIMIT  FOR LOG-ON PERIOD specifies how  much  time  to
  1295.        grant to a user before the system knows how much time he/she
  1296.        is entitled to. You should make this long enough to enable a
  1297.        new   user   to   complete  the  new  user   procedure   and
  1298.        questionnaire, if you have one.
  1299.  
  1300.        MAXIMUM  USER INACTIVITY PERIOD determines how long to  wait
  1301.        during  periods  of  inactivity  before  disconnecting.  The
  1302.        inactive  time  period is measured from the  last  character
  1303.        sent to the  modem, and users are given a  warning that they
  1304.        are  about to  be  disconnected fifteen  seconds before  the
  1305.        timer  expires. This  feature is  automatically disabled  in
  1306.        local mode, or by a setting of zero.
  1307.  
  1308.        ALLOW  USERS   TO UPLOAD MESSAGES.  When  this option is set
  1309.        to "Yes", when users enter a message  they are asked if they
  1310.        wish to "upload a prepared message?" This allows the user to
  1311.        prepare his/her messages offline and send them using  any of
  1312.        the  available  file  transfer  protocols.  Note  that  ONLY
  1313.        internal protocols may be used as RemoteAccess does not have
  1314.        enough control over the external ones. The maximum size of a
  1315.        message that may be uploaded is pre-set at 20k.
  1316.  
  1317.        The  KILL MESSAGES AFTER SENT option applies to NetMail sent
  1318.        through a mail network.  When the message is entered, if set
  1319.        to  "Ask",  it will ask the user whether to  delete  his/her
  1320.        message   after  it  has  been  exported  from  the  message
  1321.        database.
  1322.  
  1323.        STRICT  PASSWORD CHECKING is an invaluable security  feature
  1324.        which if enabled, will check passwords that users enter. You
  1325.        can specify certain undesirable passwords in a control  file
  1326.        (see  the  section on EXTERNAL FILES),  such as "Secret"  or
  1327.        "Test".  It will also disallow the user's first or last name
  1328.        as  a  password,  and checks the old and new  passwords  for
  1329.        phonetic similarity.
  1330.  
  1331.        You may also specify the minimum password length that  users
  1332.        may select.  Longer passwords mean better security,  a value
  1333.        of 4 is recommended as an absolute minimum.
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.                                     19
  1344.        If a user logs on and is disconnected because he/she  enters
  1345.        his  or her password  incorrectly,  RemoteAccess can  notify
  1346.        that user of a possible attempt at guessing the password, by
  1347.        way of a private message.  In the SECURITY WATCHDOG  MESSAGE
  1348.        AREA  field,  specify  the message area number (as per  your
  1349.        message area configuration) that the warning message  should
  1350.        be  placed  in.  A value of zero disables this  feature.  In
  1351.        addition,  you will need to create an ASCII text file called
  1352.        WATCHDOG.MSG in the system directory that contains the  text
  1353.        of the message that is sent to the user.
  1354.  
  1355.        If  ALLOW  NETMAIL  REPLIES  TO ECHOMAIL  is  enabled,  when
  1356.        replying to an EchoMail message, users will be asked if they
  1357.        would  like  to reply  directly  to  the originator  of  the
  1358.        message via netmail, rather than  replying in the same  area
  1359.        with a message  that might not be  of interest to the  other
  1360.        participants. Note  that this {+} registered  only option is
  1361.        only  enabled  if  RemoteAccess  can   determine  where  the
  1362.        original message came from.
  1363.  
  1364.        If a  user is  disconnected due to  exceeding the  incorrect
  1365.        number of password tries, you may give him/her the option of
  1366.        sending  a message to the  sysop by setting  the PWD FAILURE
  1367.        MSG  AREA to the number  of the message  area you would like
  1368.        the message to be posted in.  A value of zero disables  this
  1369.        feature. {+} Registered only.
  1370.  
  1371.        If  ASK FOR  MESSAGE DELETE  CONFIRMATION is  enabled, users
  1372.        will  be asked  for  confirmation every  time they  elect to
  1373.        delete a message from the message reading prompt.
  1374.  
  1375.  
  1376.        Select  the PAGING menu.   PAGE LENGTH  specifies the number
  1377.        of seconds   to sound the  bell at the local  console when a
  1378.        user  pages you  for a  chat.  MAXIMUM  PAGES allows  you to
  1379.        limit the  number of  times a user  may page you  during one
  1380.        session.   You may  also   specify paging "hours"  using the
  1381.        PAGING START/END TIME  option.   If either field is set to a
  1382.        non-zero   value,  users will  only be  allowed to  page you
  1383.        between these hours.
  1384.  
  1385.        If ASK FOR PAGE REASON is enabled, RemoteAccess will display
  1386.        a custom prompt  (see the SYSTEM  MESSAGES submenu) and  ask
  1387.        the user why he/she wants to chat. The response is displayed
  1388.        on  the status bar, and may be redisplayed later by pressing
  1389.        F6. {+} Registered only.
  1390.  
  1391.        If  the page  was unsuccessful,  the  user will  be prompted
  1392.        whether  to leave  a message  addressed to  the  sysop. This
  1393.        option  is enabled by setting the  AREA FOR MSGS TO SYSOP to
  1394.        the desired message area number, or disabled with a value of
  1395.        zero. {+} Registered only.
  1396.  
  1397.  
  1398.        The MESSAGES submenu allows you to customise a number of the
  1399.        most commonly used "built in" display and prompt messages.
  1400.  
  1401.  
  1402.  
  1403.  
  1404.                                     20
  1405.        The  SYSTEM submenu  contains  options that  pertain to  the
  1406.        hardware/software   environment   plus  some   other  global
  1407.        options.
  1408.  
  1409.        If  you  set  ALLOW  FAST LOGONS  to  "Yes",  then  whenever
  1410.        RemoteAccess is activated in local mode, it will assume that
  1411.        it  is  the sysop who is logging on,  and  will  prompt  for
  1412.        password only.
  1413.  
  1414.        If you are running more than one line,  you should set CHECK
  1415.        FOR  MULTI-LOGON  to "Yes".  This will prevent a  user  from
  1416.        logging  on  to  more than one line at the  same  time,  and
  1417.        effectively  using his/her entire daily time limit  on  EACH
  1418.        LINE.
  1419.  
  1420.        If  you  never (or rarely) call your own BBS  remotely,  you
  1421.        should  disallow sysop remote access by setting ALLOW  SYSOP
  1422.        REMOTELY  to "No".  This makes it almost impossible  for  an
  1423.        unknown  "hacker" to gain access to your system via your own
  1424.        account.
  1425.  
  1426.        EXCLUDE  SYSOP FROM LIST,  if set to "Yes",  will cause  the
  1427.        sysops name to be ommitted from a User List, List of Today's
  1428.        Callers,  Who Else Is Online, and the Last Caller functions.
  1429.  
  1430.        By  inserting  a special control code in a text file  it  is
  1431.        possible to automatically activate a program in a shell when
  1432.        the  text file is displayed.  As explained in the TEXT  FILE
  1433.        CONTROL   CODES  section,   there  are  important   security
  1434.        considerations that must be looked into if you intend to use
  1435.        this feature. If you aren't going to use it, set SHELLS FROM
  1436.        TEXT FILES to "No".
  1437.  
  1438.        The  next  option in the SYSTEM menu is the SYSTEM LOG  FILE
  1439.        NAME.  RemoteAccess  logs all user activity in detail  to  a
  1440.        human-readable  text  file.  {+} When  running in registered
  1441.        mode, RemoteAccess logs additional information about message
  1442.        and file area  activity.Set the  name of  the log  file   to
  1443.        point to your system directory, for example C:\RA\RA.LOG.
  1444.  
  1445.        Next,  select  the logging format that most suits you;  Opus
  1446.        mode contains more information, including the line number in
  1447.        a  multi-line  system.  The FrontDoor format  is  much  more
  1448.        compact.
  1449.  
  1450.        If you are installing RemoteAccess on a multi-line site (ie.
  1451.        you  are going to be running more than one line),  you  MUST
  1452.        set  the  MULTI  LINE  option  to "Yes".  This enables extra
  1453.        file/message  checking  routines to ensure that  a  conflict
  1454.        between  two lines accessing the same data never arises.  If
  1455.        you are running only one line,  setting this option to "Off"
  1456.        will  disable this checking and significantly increases  the
  1457.        system's operating speed.
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.                                     21
  1466.        The  ENVIRONMENT option refers to the type of  multi-tasking
  1467.        system  that you will be running RemoteAccess under.  If set
  1468.        to "Auto-detect", RemoteAccess will attempt to determine the
  1469.        multitasker   in   use   when   it   fires   up.   On   some
  1470.        hardware/software  configurations  it  may not  be  able  to
  1471.        correctly detect it's environment. To overcome this, you can
  1472.        force  RemoteAccess to "assume" that it is running  under  a
  1473.        specific  multitasker.  Environments currently supported are
  1474.        DoubleDOS,  DESQview, TopView, MultiLink, PC-MOS/386 and the
  1475.        "standard" AT BIOS. RemoteAccess will time-slice, or give up
  1476.        CPU time, to other tasks when it is waiting for a call or at
  1477.        a  prompt.  The  result  is  a  significant  overall  system
  1478.        performance improvement.
  1479.  
  1480.        To avoid screen "burn in" on the "waiting for call" display,
  1481.        set  the SCREEN BLANKER to  the number of  seconds you would
  1482.        like the  display to remain visible after the last activity.
  1483.        This is a {+} registered only option.
  1484.  
  1485.        After  RemoteAccess displays a  system message,  the default
  1486.        action is to  wait for  one second before  returning to  the
  1487.        current  menu. You may alter this wait period by setting the
  1488.        AFTER  SYSTEM  MESSAGES  option  to the  desired  number  of
  1489.        seconds.  There is one  special exception;  if you  set this
  1490.        field  to  zero,  instead  of  waiting  for  a  few seconds,
  1491.        RemoteAccess  will prompt the user to press the Enter key to
  1492.        continue.
  1493.  
  1494.        The  INTERACTIVE EMSI option simply allows  you to enable or
  1495.        disable RemoteAccess'  IEMSI  capabilities. IEMSI  is  fully
  1496.        explained in  the  reference  section at  the  end  of  this
  1497.        manual.
  1498.  
  1499.        The last option  in the OTHER  menu is ALT-FKEYS.   When one
  1500.        of the  ten  function  keys  on your  keyboard  is   pressed
  1501.        in conjunction   with the ALT key,  RemoteAccess will do one
  1502.        of  three things  :  If the  command  string that  you  have
  1503.        assigned to the  function key that  is pressed is a standard
  1504.        DOS  command line,   then  that  line  will be executed in a
  1505.        shell  while RemoteAccess  remains in memory.   If,  on  the
  1506.        other hand, the first   character of the command  string for
  1507.        the function   key  is the  query symbol  (?) followed by  a
  1508.        number,  RemoteAccess  will exit to  DOS with an  errorlevel
  1509.        equal to  the number. Alternatively, if  the first character
  1510.        of the  command string  is the  hash (#),  RemoteAccess will
  1511.        display the named text file from the textfile directory. For
  1512.        example, suppose three entries looked like this:
  1513.  
  1514.             5 : ?110
  1515.             6 : C:\COMMAND.COM
  1516.             7 : #WELCOME
  1517.  
  1518.        Pressing ALT-F5 would cause RemoteAccess to exit to DOS with
  1519.        an   errorlevel  of  110, ALT-F6  would execute a  copy   of
  1520.        COMMAND.COM  in  a  shell,  and  ALT-F7  would  display  the
  1521.        appropriate (ASC/ANS)  version of  your WELCOME.A??  file to
  1522.        the user.
  1523.  
  1524.  
  1525.  
  1526.                                     22
  1527.        Events             
  1528.        ────────────────────────────────────────────────────────────
  1529.  
  1530.        The  RemoteAccess  Event  Editor  allows  you  to  set  pre-
  1531.        determined  times  during  the week when  RemoteAccess  will
  1532.        automatically  exit to your batch file and  perform  certain
  1533.        functions,  usually some kind of system maintenance.  Select
  1534.        EVENTS  from  the main menu bar.  This window  contains  all
  1535.        event information.  You may define up to 20 events to run at
  1536.        any  time during the day.  In addition to this,  it is  also
  1537.        possible  to specify that an event only run on a  particular
  1538.        day or days of the week.
  1539.  
  1540.        To  modify  an event,  simply move the highlight bar to  the
  1541.        event you wish to alter, and press [CR]. Use the cursor keys
  1542.        to move between entries in the event edit window,  and enter
  1543.        the time you want the event to start at,  in 24 hour format.
  1544.  
  1545.        Next,  enter  the errorlevel;  when the event is  activated,
  1546.        RemoteAccess  will exit to the batch file from which it  was
  1547.        called at this errorlevel.  Your batch file should trap this
  1548.        errorlevel and act accordingly. In this window, you can also
  1549.        specify  what days you would like the event to run  on,  and
  1550.        whether  the  event is  enabled or  disabled.   If  a user's
  1551.        upload or download  overruns an event  which is FORCED  then
  1552.        the transfer  will be aborted  and the user  disconnected to
  1553.        ensure  that  the  event  runs  at  the  proper  time.  More
  1554.        information  on trapping  events is  contained in  the BATCH
  1555.        FILE EXAMPLES section.
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.                                     23
  1588.        Files                       
  1589.        ────────────────────────────────────────────────────────────
  1590.                     
  1591.        Select  the FILE AREAS submenu.  This  is  where  you define
  1592.        your file areas.  
  1593.  
  1594.        Usually your file areas will be grouped by area of interest.
  1595.        For  example, file area 1  might be "DOS  utilities", area 2
  1596.        "Pascal programming files", area 3 "Graphics picture files",
  1597.        and so on.
  1598.  
  1599.        Most  of the entries here are  fairly  straightforward.  The
  1600.        FILE AREA NAME is the name of the file area as the user will
  1601.        see  it.  The FILE PATH is a fully qualified directory  path
  1602.        that points to where the files in this area are stored,  for
  1603.        example   C:\FILES\IBM\GAMES\.   Note   that  the   trailing
  1604.        backslash is optional.
  1605.  
  1606.        The list  of files that your users see for a particular area
  1607.        is  generated from a textfile that you can edit yourself. By
  1608.        default, this file is called FILES.BBS and is located in the
  1609.        same directory as  the files  it describes. When  a file  is
  1610.        uploaded  to  a  file   area,  RemoteAccess  creates  a  new
  1611.        FILES.BBS  if it doesn't  already exist, and  then appends a
  1612.        single line entry for  the file. The format of  FILES.BBS is
  1613.        simple:
  1614.  
  1615.        <FILENAME.EXT> <Description>
  1616.  
  1617.        Filenames that  contain wildcard / pattern  match characters
  1618.        are expanded  to full  filename specs.  A separate entry  is
  1619.        displayed for each matching file found.
  1620.  
  1621.        The <Description> field  may be up  to 255 characters  long.
  1622.        When displayed to the  user the description is automatically
  1623.        word wrapped to the width of the user's screen.
  1624.  
  1625.        If  you have  some  kind of  read-only  mass storage  device
  1626.        online such as a  CD-ROM, then it usually isn't  possible to
  1627.        have  a FILES.BBS in each file directory. To get around this
  1628.        problem simply  create a separate  directory to hold  all of
  1629.        the FILES.BBS  files. The  individual files should  be names
  1630.        FILES.n, where n is the file area number. For example -
  1631.  
  1632.        C:\RA\CDROMLST\FILES.33
  1633.  
  1634.        Is the  file that  would be read  in place of  FILES.BBS for
  1635.        area number 33. In this example,  the FILE LIST path (in the
  1636.        PATHS section of RACONFIG) has been set to C:\RA\CDROMLST.
  1637.  
  1638.        Access  to  each  file area is  controlled  by  raising  the
  1639.        SECURITY LEVEL and FLAGS to the minimum combination required
  1640.        for  a user to "see" the area.  For example,  if a user uses
  1641.        the  "Search  for new files" function,  only file  areas  to
  1642.        which he/she has the required security/flags setting will be
  1643.        checked.  The   EXTERNAL  SUPPORT  FILES   section  contains
  1644.        information  on  marking  files  as  free  and/or   password
  1645.        protected under the subheading FILES.CTL.
  1646.  
  1647.  
  1648.                                     24
  1649.        Next go to the GLOBAL OPTIONS submenu.
  1650.  
  1651.        The  UPLOAD  CREDIT FACTOR provides a way of rewarding  your
  1652.        users for uploading files to you.  If this value is set to a
  1653.        non-zero  value,  after  each upload session,  the  user  is
  1654.        granted that many seconds per minute of upload time.  So, if
  1655.        you set the credit factor to 30 (seconds), and a user spends
  1656.        10  minutes uploading,  he/she would be granted an  extra  5
  1657.        minutes for that session. Note that during uploads the timer
  1658.        is "frozen" in addition to this bonus.
  1659.  
  1660.        When a user gets a list of files in a file area,  the format
  1661.        of  a  file  entry  is  the  file  name,  length,  date  and
  1662.        description. It is possible to omit the date from each line,
  1663.        thus making it possible to have more verbose descriptions by
  1664.        setting SHOW FILE DATES to "No". 
  1665.  
  1666.        Note that the asterisk normally displayed immediately  after
  1667.        the date which indicates the file is new since the last log-
  1668.        on is still displayed.
  1669.                     
  1670.        When  a  file  is uploaded using a batch  protocol  such  as
  1671.        Zmodem, or Ymodem, the original date of the file is normally
  1672.        preserved when the file is saved in the upload area. This is
  1673.        of little use if the file was originally created in 1987, so
  1674.        RemoteAccess will,  if the RESET UPLOAD FILE DATES option is
  1675.        enabled,  reset  the  date stamp of the file to the date  on
  1676.        which it was uploaded.
  1677.  
  1678.        When a  user displays a list of files, the default action is
  1679.        to  show missing files as  "<MISSING>". The next two options
  1680.        determine whether these missing  files are displayed, and if
  1681.        so  what  message  is  displayed. {+}  The  message  is only
  1682.        configurable in the registered version.
  1683.  
  1684.        It  is  possible to disable uploads when the amount of  free
  1685.        space on your upload drive falls below a preset  level.  For
  1686.        example, to disable uploads if there is less than 1 megabyte
  1687.        free, set MINIMUM UPLOAD SPACE to 1000 (kilobytes).
  1688.  
  1689.        If the SCAN NEW FILES  AT LOGON option is enabled,  the user
  1690.        will be given the opportunity to run a check for files which
  1691.        are new since his/her last call.
  1692.  
  1693.  
  1694.        The  INTERNAL  PROTOCOLS  submenu  allows  you  to  disable,
  1695.        enable, or  make available only  on an error-free  (ie. MNP)
  1696.        connect, any of the six internal protocols. {+} This is only
  1697.        available in the registered version.
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.                                     25
  1710.        Select the  EXTERNAL PROTOCOLS submenu.   This option allows
  1711.        you  to interface up to fifteen  external protocols for your
  1712.        users to  use,  in addition   to the six that are  built-in.
  1713.        When  a user selects to  upload  or download a file,  he/she
  1714.        is presented  with   a hard-coded   menu    that  lists  the
  1715.        available    protocols, including   your   external   ones. 
  1716.        The  NAME  field  is  the  protocol  name that the user sees
  1717.        in  this menu.    The KEY    is the    keypress that  should
  1718.        activate  the protocol.  Note  that  the KEY must be unique.
  1719.        In other words, since [Z]modem is  an internal protocol, you
  1720.        can't use [Z] to activate an external protocol.
  1721.  
  1722.        Before  RemoteAccess  activates the  external  protocol,  it
  1723.        creates  a control file that tells the protocol which  files
  1724.        to  send  or receive.  This file consists  of  some  general
  1725.        information  and  a list of files,  one per  line.  You  may
  1726.        define  exactly  what each line looks like.  If  you  select
  1727.        EXTENDED  CONTROL  FILE,  then RemoteAccess will  write  the
  1728.        information  needed by Opus-compatible external protocols at
  1729.        the  beginning of the file  before the file  list. Check the
  1730.        documentation  for each  protocol you  install to  determine
  1731.        whether it is "Opus compatible".
  1732.  
  1733.        If  the protocol has the capability to send or receive  more
  1734.        than one file at a time, set BATCH AVAILABLE to "Yes".
  1735.  
  1736.        You may temporarily disable the current protocol by  setting
  1737.        its  status to DISABLED,  re-enabling it later by setting it
  1738.        to ENABLED.
  1739.  
  1740.        The LOG FILE NAME is the full path and name of the log  file
  1741.        that  the  external  protocol  writes.  This  file  contains
  1742.        information about what files were actually sent or received.
  1743.        Without  this information,  RemoteAccess will not be able to
  1744.        update the  user's record. Most protocols  have the facility
  1745.        to  create a  log of  the files  that were actually  sent or
  1746.        received; if the protocol you are  installing doesn't, it is
  1747.        advisable not to use it.
  1748.  
  1749.        The  CONTROL  FILE  NAME is the full path and  name  of  the
  1750.        control file that RemoteAccess creates before activating the
  1751.        protocol.  In  order to allow the use of as  many  different
  1752.        protocols as possible, you have full control over the format
  1753.        of  this file.  The DOWNLOAD CONTROL STRING determaines  the
  1754.        format  of  each file entry.  Inserting a "@" in the  string
  1755.        substitutes that position with the file name.  For  example,
  1756.        if      you     wanted     to     download     the      file
  1757.        C:\FILES\IBM\FUN\CASINO.ZIP  using  an  Opus  type  external
  1758.        protocol, you would set the control file string to:
  1759.  
  1760.             Send @
  1761.  
  1762.        When the control file is created, this would be expanded to:
  1763.  
  1764.             Send C:\FILES\IBM\FUN\CASINO.ZIP
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.                                     26
  1771.        If  the user were to select a batch download,  say  RA*.ZIP,
  1772.        the  wildcard/pattern  match is expanded to a full  list  of
  1773.        fully qualified path and file names.
  1774.  
  1775.        The  UPLOAD  CONTROL STRING works in exactly the  same  way,
  1776.        except  that  for batch uploads,  instead of specifying  the
  1777.        full file name,  it substitutes just the path to the  upload
  1778.        directory,  as  the  filenames  are not known prior  to  the
  1779.        upload.
  1780.  
  1781.        UPLOAD/DOWNLOAD COMMAND LINE tells RemoteAccess what program
  1782.        name to execute in order to activate the external  protocol.
  1783.        It  is  possible to insert variables into the  command  line
  1784.        using special control characters. For example, the string:
  1785.  
  1786.             PROTNAME.EXE Send *B
  1787.  
  1788.        would be expanded to:
  1789.  
  1790.             PROTNAME.EXE Send 2400
  1791.  
  1792.        For  a  full  list of special control codes,  refer  to  the
  1793.        description  of a Type 7 menu command in the  MENU  COMMANDS
  1794.        section.  In  addition to these codes,  the # symbol can  be
  1795.        used  if  the  filename  to  send or  receive  needs  to  be
  1796.        specified on the command line.
  1797.  
  1798.        When  the  external  protocol has finished  and  control  is
  1799.        returned  to RemoteAccess,  the log file that was created is
  1800.        scanned to extract information about what files were sent or
  1801.        received.  RemoteAccess  scans  the file for the  UPLOAD  or
  1802.        DOWNLOAD LOG KEYWORD. As soon as it finds that word, it will
  1803.        scan  forward x number of words to get the name of the  file
  1804.        transferred and a description,  if available.  To illustrate
  1805.        how this works, look at this extract from a BiModem log:
  1806.  
  1807.        = 10 Sep 14:10:10 BMOD DL-B \GRAPHICS\FORMATS\LOCKLEAR.ZIP
  1808.        = 10 Sep 14:12:22 BMOD DL-B \GRAPHICS\FORMATS\AWESOME.ZIP
  1809.  
  1810.        The  DOWNLOAD  LOG KEYWORD can be any word in the  log  file
  1811.        that  indicates the transfer of a single file.  The  keyword
  1812.        would  be  set  to "DL-B",  and the NAME WORD #  set  to  1.
  1813.        RemoteAccess  scans the above entries until it hits  "DL-B",
  1814.        and then counts forward 1 word to get the file name. Uploads
  1815.        work in the same way, but a description word number may also
  1816.        be specified,  as some protocols get file descriptions  from
  1817.        the user directly. If RemoteAccess finds a description it is
  1818.        appended  to  the end of the FILES.BBS file,  otherwise  the
  1819.        user is prompted for the description.
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.                                     27
  1832.        Example : Installing Lynx as an external protocol
  1833.        -------------------------------------------------
  1834.  
  1835.        Select  an  empty  protocol slot,  and enter  the  following
  1836.        information:
  1837.  
  1838.        Name                  : Lynx
  1839.        Key                   : L
  1840.        Extended control file : No
  1841.        Batch available       : Yes
  1842.        Status                : Enabled
  1843.        Log file name         : C:\Ra\Dszlog.Txt
  1844.        Control file name     : C:\Ra\Lynx.Ctl
  1845.        Download command line : Lynx.Exe S /*P /*B /S /H @Lynx.Ctl
  1846.        Upload command line   : Lynx.Exe R /*P /*B /S /D /H #
  1847.        Download ctl string   : @
  1848.        Upload ctl string     :
  1849.        Download log keyword  : x
  1850.        Upload log keyword    : X
  1851.        Log : Name word #     : 10
  1852.        Log : Desc word #     : 0
  1853.  
  1854.        (Note  the  case  of  the upload and  download  log  keyword
  1855.        entries).
  1856.  
  1857.        The  above  example assumes that your  system  directory  is
  1858.        C:\RA.  To complete the installation, you'll need to set the
  1859.        DSZLOG environment variable to the full path and name of the
  1860.        log file that Lynx writes:
  1861.  
  1862.             SET DSZLOG=C:\Ra\Dszlog.Txt
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.                                     28
  1893.        Messages                         
  1894.        ────────────────────────────────────────────────────────────
  1895.  
  1896.        The  last configuration section is the message  areas.  From
  1897.        the  MESSAGES menu,  select MESSAGE AREAS. You may define up
  1898.        to  200 different areas,  each with it's own attributes  and
  1899.        security requirements.
  1900.  
  1901.        Firstly,  give the area a name.  This should be a meaningful
  1902.        description  of  its  content,   for  example  "IBM  Users",
  1903.        "Cooking",   or  "Entertainment".  Avoid  using  names  like
  1904.        "Message Area 1".  If you wish to "delete" the message area,
  1905.        simply set the area name to nothing.
  1906.  
  1907.        Each area can be one of three TYPES.  LOCAL,  if the message
  1908.        area is available on your BBS only,  or if you are in a mail
  1909.        network such as FidoNet,  ECHOMAIL or NETMAIL.  These latter
  1910.        two  types  are explained more fully in the MAIL  NETWORKING
  1911.        section. If you are not part of a mail network, set the type
  1912.        to LOCAL.
  1913.  
  1914.        MESSAGE STATUS controls the types of messages that users are
  1915.        allowed to post in the area.  You have the choice of PRIVATE
  1916.        ONLY,  PUBLIC ONLY,  PRIVATE/PUBLIC and READ ONLY. It may be
  1917.        desirable   to  allow  only  public  messages   in   general
  1918.        discussion  areas,  or likewise private only in user-to-user
  1919.        message  areas to ensure that all messages in that area  may
  1920.        be read only by the sender or the recipient of the  message.
  1921.        Message  areas  marked as READ ONLY may only  have  messages
  1922.        posted  in  them by the sysop.  This is useful  for,  say  a
  1923.        general announcement area.
  1924.  
  1925.        Each message  area  may be  configured  via the  USER  NAMES
  1926.        option, to  allow users  to  post messages  with real  names
  1927.        only,   handles  only   (this   is   the  user's   permanent
  1928.        "registered" handle),  or with an  alias which the  user may
  1929.        select at the time the message  is posted. RemoteAccess will
  1930.        not allow the use of the alias "Sysop".
  1931.  
  1932.        The  next three options are used by RAMSG,  the message-base
  1933.        maintenance  utility.  In  order to keep the  size  of  your
  1934.        message-base   files  down  to  a  reasonable  level  it  is
  1935.        necessary to regularly delete "old" messages. You should set
  1936.        these  options according to the requirements of  each  area.
  1937.  
  1938.        For  further details,  see  the section  on maintaining  the
  1939.        message database files.
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.                                     29
  1954.        For  example,  if the area is high-traffic,  by setting DAYS
  1955.        UNTIL  OLD MESSAGES ARE KILLED to 7,  RAMSG will delete  any
  1956.        message  in that area that is over a week old.  You can  use
  1957.        these  options  in combination.  By setting DAYS  UNTIL  OLD
  1958.        MESSAGES ARE KILLED to 14 and MAXIMUM NUMBER OF MESSAGES  to
  1959.        200,  RAMSG  will  delete any message in that area which  is
  1960.        either  over 14 days old as well as the oldest  messages  in
  1961.        the  area  until there are only 200 messages  left.  If  the
  1962.        message  area is important,  say user-to-user private  mail,
  1963.        you  can  instruct RAMSG to delete only messages which  have
  1964.        already been received that are a certain number of days  old
  1965.        by  setting  the  DAYS AFTER RECEIVED  MESSAGES  ARE  KILLED
  1966.        option.
  1967.  
  1968.        The default action for an EchoMail message area is to append
  1969.        an  origin line (see the section on MAIL NETWORKING for more
  1970.        on this) to each  outgoing message. This may be  disabled by
  1971.        setting the APPEND ECHOMAIL INFO flag to "No".
  1972.  
  1973.        The ALLOW COMBINED ACCESS  flag determines whether users may
  1974.        select  the current message  area as part  of their combined
  1975.        message area configuration.
  1976.  
  1977.        RemoteAccess  provides an extremely  powerful facility which
  1978.        allows users to  attach one or more files to a message. This
  1979.        means  that users  can send  each other files  privately. To
  1980.        enable this option,  set ALLOW FILE ATTACHES  to "Yes". Also
  1981.        ensure that the FILE ATTACH PATH  in the OTHER/PATHS submenu
  1982.        points  to a  directory  which exists.  When a  user uploads
  1983.        files with a message,  RemoteAccess creates a uniquely named
  1984.        subdirectory in this directory,  and places all the attached
  1985.        files in  it. After the  recipient has received  the message
  1986.        and  confirmed that he/she  received all the  files, all the
  1987.        files  and the  directory are deleted.  {+} This  feature is
  1988.        only available in the registered version.
  1989.  
  1990.        The  AKA  ADDRESS  and  ORIGIN LINE  options  are  used  for
  1991.        EchoMail type areas.  You can set different origin lines for
  1992.        each area,  along with any one of your network addresses, to
  1993.        be  appended  to the end of messages that are posted in  the
  1994.        area. If no origin line is specified, then RemoteAccess will
  1995.        use  the  origin  line defined in the  DEFAULT  ORIGIN  LINE
  1996.        option.
  1997.  
  1998.        Access to the message area is controlled by READ,  WRITE and
  1999.        SYSOP security levels and access flags. Read Security is the
  2000.        minimum security level the user needs to be allowed to  read
  2001.        messages in each message area. Likewise, message posting and
  2002.        replying  is only permitted if the user's security level  is
  2003.        equal  to or higher than the Write Security  setting.  SYSOP
  2004.        security access permits reading of all messages in the area,
  2005.        even if they are private and addressed to another user. This
  2006.        is useful  for  message  areas  which  are  run by assistant
  2007.        sysops and the like, so they can check messages for suitable
  2008.        content  and  delete off-topic ones.  A full  discussion  on
  2009.        security can be found in the SECURITY section.
  2010.  
  2011.  
  2012.  
  2013.  
  2014.                                     30
  2015.        Select the GLOBAL OPTIONS submenu.
  2016.  
  2017.        CHECK  FOR  MAIL AT LOG-ON,  when enabled,  will  force  the
  2018.        system  to scan the message-base for new mail  addressed  to
  2019.        the  user  (regardless of what area it is in,  provided  the
  2020.        user has access to that area) at log-on.
  2021.  
  2022.        The FULL MAIL CHECK option determines the type of mail check
  2023.        that is performed.  A full check scans from the start to the
  2024.        end  of the message-base for all mail addressed to the  user
  2025.        that does not have the "Received" flag set.  If you set  the
  2026.        option  to "Off",  the message base is only checked from the
  2027.        last message that the user read.  While this is much faster,
  2028.        there  is the possibility that some mail may be  skipped  if
  2029.        the  user  elected not to read his/her mail during the  last
  2030.        logon.
  2031.  
  2032.        The  QUOTE STRING is a highlight character that RemoteAccess
  2033.        will place in front of any message that is replied  to.  For
  2034.        example,  a  message quoted using " > " as the quoter  would
  2035.        look like:
  2036.  
  2037.               > I have been using RemoteAccess for 2 months now and
  2038.               > love it!
  2039.                          
  2040.             I have to agree with you there,  Tom.  Flexibility-wise
  2041.            you just can't beat it.
  2042.  
  2043.        A  '@' character in the quote string will be translated into
  2044.        the initials of the person whose message is being quoted.
  2045.  
  2046.        If the RENUMBER THRESHOLD option is set to a non-zero value,
  2047.        RAMSG   will  automatically  renumber   the  entire  message
  2048.        database  when  the  highest  message  number   reaches  the
  2049.        predetermined value.
  2050.  
  2051.        EXTERNAL  EDITOR.  This is the DOS command line that will be
  2052.        used  to activate a full screen message editor,  if  one  is
  2053.        installed.  This  option is available only to users of  ANSI
  2054.        graphics.  The  full screen editor is a third-party  package
  2055.        that  enables messages to be entered in a  "word-processing"
  2056.        environment,   with  cursor  movement  and  text  formatting
  2057.        ability.   QuickEd  is  one  such  package  that  interfaces
  2058.        directly to RemoteAccess.  This command line may contain any
  2059.        of  the metacommands listed in the description of the type 7
  2060.        menu  command,  including  *M to swap  RemoteAccess  out  of
  2061.        memory before the editor is loaded.
  2062.  
  2063.        Set the ORIGIN LINE  to the message you would  like appended
  2064.        to all outgoing EchoMail messages.  This will take effect in
  2065.        all  areas except where  you have entered  a specific origin
  2066.        line for a particular area.
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.                                     31
  2076.        The REPLY HEADER is displayed at the top of a message when a
  2077.        user replies to a message that was not  originally addressed
  2078.        to him/her. The following macro characters may be used:
  2079.  
  2080.             @ - Person the original message was addressed to,
  2081.             # - Person who posted the original message,
  2082.             ` - Date of the original message,
  2083.             ~ - Time of the original message.
  2084.  
  2085.        The last three  options in  this submenu  relate to  sending
  2086.        netmail messages as  "crash", or immediately, and  attaching
  2087.        files to netmail messages.
  2088.  
  2089.  
  2090.        The  DEFAULT   COMBINED  SETTINGS  submenu   allows  you  to
  2091.        predefine  the  initial combined  mesage  area configuration
  2092.        that is given to new users.
  2093.  
  2094.        Go  to the QUIT menu,  and select "Yes" to save any  changes
  2095.        that  have  been  made.   This  completes  the  tutorial  on
  2096.        RACONFIG.
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.                                     32
  2137.        SECURITY            
  2138.        ────────────────────────────────────────────────────────────
  2139.  
  2140.        All user-security is controlled by a security level and  set
  2141.        of access flags.  The security level is any number from 1 to
  2142.        64,000.  Setting  a user's security level to zero will  lock
  2143.        him or her out of the BBS. There are thirty-two access flags
  2144.        arranged  in  four sets of eight individual flags,  each  of
  2145.        which can be either ON or OFF.  An ON flag is represented by
  2146.        an "X", and an OFF flag by a "-".
  2147.  
  2148.        Firstly let's look at menu security. Each menu is made up of
  2149.        a number  of  lines,  each  of  which  may  have  a  command
  2150.        associated with it.  (The  structure  of menus  is explained
  2151.        fully  in the next section).  In order for a menu line to be
  2152.        visible  (and  selectable) to a user,  the  user's  security
  2153.        level  must be equal to or greater than the  security  level
  2154.        assigned to that line.  In addition to this, every flag that
  2155.        is set ON in the menu line must also be set ON in the user's
  2156.        flag setting. 
  2157.  
  2158.        Read/Write  and Sysop access to message areas is  controlled
  2159.        in the same way. To be able to read messages in an area, the
  2160.        user  must  have not only a sufficient security  level,  but
  2161.        also  at  least the flags that are defined in  RACONFIG  for
  2162.        that  area.  Similarly,  the file area access  security/flag
  2163.        system works in the same way,  BUT the settings only  affect
  2164.        the   three   file  search  menu  functions.   To   restrict
  2165.        up/download  access to certain areas,  you will have to  use
  2166.        menu security.
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.                                     33
  2198.        MENUS                                   
  2199.        ────────────────────────────────────────────────────────────
  2200.  
  2201.        This  is  possibly the most important stage  in  configuring
  2202.        your  BBS.  The  menus that you create will give the  system
  2203.        it's own "feel",  and will make your system look  completely
  2204.        different from the one next door.  The menu system gives you
  2205.        one hundred percent flexibility not  only  cosmetically, but
  2206.        in allowing and disallowing access to certain functions  and
  2207.        parts of your BBS to groups of users.
  2208.  
  2209.        The menus are line-oriented. Using the menu editor supplied,
  2210.        you  enter the lines one at a time.  Each line has a line of
  2211.        text that is displayed to the user, a menu "type", a minimum
  2212.        security  level  and flag setting required  to  access  that
  2213.        line,  and  some  optional  data that is used by  some  menu
  2214.        types. 
  2215.  
  2216.        There  are  approximately sixty menu functions that  may  be
  2217.        activated  by the user pressing the key you have  linked  to
  2218.        that  function.  These functions are explained fully in  the
  2219.        following pages.
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.                                     34
  2259.        Menu functions                            
  2260.  
  2261.  
  2262.        Type          : 1
  2263.        Name          : Goto another menu
  2264.        Optional Data : <Menu Name> [Password] [/F=<File Area>|+|-]
  2265.                        [/M=<Message Area>|+|-] 
  2266.  
  2267.        This function causes a jump to another menu,  which has been
  2268.        created  with  the  editor  and saved  as  <Menu  Name>.  If
  2269.        [Password]  is  specified  then the user will  be  asked  to
  2270.        supply  a  non-case-sensitive  password  before  proceeding.
  2271.        <File  Area> and <Message Area> set the  currently  selected
  2272.        file and message areas respectively for the template system.
  2273.        See the section on MENU TEMPLATES for a full explanation  on
  2274.        this.
  2275.  
  2276.  
  2277.  
  2278.        Type          : 2
  2279.        Name          : Gosub another menu
  2280.        Optional Data : <Menu Name> [Password] [/F=<File Area>|+|-] 
  2281.                        [/M=<Message Area>|+|-] 
  2282.  
  2283.        As for Function 1,  but saves the path to the last menu on a
  2284.        "stack",  making  it possible to return to the calling  menu
  2285.        with  a type 3 function.  Note that menus called in this way
  2286.        may be nested to a maximum of 50 levels.
  2287.  
  2288.  
  2289.  
  2290.        Type          : 3
  2291.        Name          : Return from gosub 
  2292.        Optional Data : None
  2293.  
  2294.        Use  this  function to return from a Gosub (type 2)  to  the
  2295.        previous menu.
  2296.  
  2297.  
  2298.  
  2299.        Type          : 4
  2300.        Name          : Goto menu after clearing menu stack
  2301.        Optional Data : <Menu Name> [Password] [/F=<File Area>|+|-]
  2302.                        [/M=<Message Area>|+|-] 
  2303.  
  2304.        As for function 1,  but  before jumping to the new menu, the
  2305.        gosub menu stack is cleared.  Obviously you can't use a type
  2306.        3 return straight after this!
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.                                     35
  2320.        Type          : 5
  2321.        Name          : Display a *.ASC/*.ANS text file
  2322.        Optional Data : <1-8 character name>
  2323.  
  2324.        Displays  a file in your textfile directory (as  defined  in
  2325.        RACONFIG). If the user has ANSI enabled, then <Filename.ANS>
  2326.        will  be displayed.  If the user does not have ANSI enabled,
  2327.        or  <Filename.ANS>  is missing then <Filename.ASC>  will  be
  2328.        displayed.  It  is possible to display comprehensive  system
  2329.        and  user details by inserting special control codes in  the
  2330.        file.  These codes are listed in the TEXT FILE CONTROL CODES
  2331.        section.
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.                                     36
  2381.        Type          : 6
  2382.        Name          : Bulletin menu
  2383.        Optional Data : <1-8 character name>
  2384.  
  2385.        Displays  the  <1-8 character name> file in your  text  file
  2386.        directory as does function type 5. The user is then prompted
  2387.        for a file suffix of length 8 - <length of file>. The suffix
  2388.        is appended to the original file name, and that text file is
  2389.        displayed as it would be in a type 5 function.  For example,
  2390.        if  the  optional  data  field  contained  a  file  name  of
  2391.        BULLET, the  file BULLET.ASC/ANS would  be  displayed.  Then
  2392.        the  user is prompted for a 2 character input.  If the  user
  2393.        typed  in "1B",  then the file "BULLET1B.ASC/ANS"  would  be
  2394.        displayed.  The  original text file defined in the  optional
  2395.        data should therefore contain a list of available bulletins.
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.                                     37
  2442.        Type          : 7
  2443.        Name          : Run an external program in a shell
  2444.        Optional Data : <Command Line> [Control Codes]
  2445.  
  2446.        This  command  will run an external program (a "door") in  a
  2447.        shell while the user is on-line. Examples are on line games,
  2448.        mail-checking facilities and so on. (Refer also to type 15 -
  2449.        Exit  to  DOS  for an alternative way  of  running  external
  2450.        programs). The FULL name of the program must be specified if
  2451.        it is an .EXE or .COM file.  To run one of these two  simply
  2452.        put  the name of the program in the optional data field.  If
  2453.        you  wish  to  call a batch file,  this  must  be  done  via
  2454.        COMMAND.COM,  the memory-resident command-line processor. So
  2455.        to  run  your TradeWars batch file,  the command line  could
  2456.        read:
  2457.  
  2458.             C:\COMMAND.COM /C \BBS\DOORS\TW2.BAT
  2459.  
  2460.        Many programs require extra information to be passed on  the
  2461.        command line, so the following control codes may be used. In
  2462.        each case, the code is replaced by it's value:
  2463.  
  2464.             *A : Write the user's handle (if any) in DORINFO.DEF   
  2465.                  instead of the user's real name.
  2466.  
  2467.             *B : User's baud rate, or 0 if local
  2468.  
  2469.             *C : Full path and name to COMMAND.COM
  2470.  
  2471.             *D : Automatically generate the Doorway DOOR.SYS       
  2472.                  parameter file.
  2473.  
  2474.             *F : User's first name
  2475.  
  2476.             *G : ANSI graphics, 0=Off/1=On 
  2477.  
  2478.             *H : Normally  the  FOSSIL  is  de-initialised   before
  2479.                  running an external program to avoid any possible 
  2480.                  conflicts  between  the  FOSSIL and  the  program.
  2481.                  Specifying this parameter leaves the FOSSIL  "hot"
  2482.                  or active. 
  2483.  
  2484.             *L : User's last name
  2485.  
  2486.             *M : Activate MemorySwap feature. RemoteAccess attempts
  2487.                  to  swap itself and all the memory it occupies  to
  2488.                  EMS  (if  installed) and disk,  leaving  only  20k
  2489.                  resident.    Great   for   running   memory-hungry
  2490.                  programs,  but  it  takes a few seconds to do  the
  2491.                  swap.  If  it  can't do the swap,  it will  try  a
  2492.                  normal shell.  NOTE :  Some programs are notorious
  2493.                  for  "fragmenting" memory,  and will not work with
  2494.                  MemorySwap.  Programs compiled in QuickBASIC, such
  2495.                  as TradeWars 1000 exhibit this problem.
  2496.  
  2497.             *N : Line number,  as specified  by the -N command line
  2498.                  parameter
  2499.  
  2500.  
  2501.  
  2502.                                     38
  2503.             *Oxxx : Override the baudrate value passed on to the   
  2504.                  called program with xxx.
  2505.  
  2506.             *P : Communications port being used (1-4)
  2507.  
  2508.             *R : User's record number in the user file
  2509.  
  2510.             *T : Time remaining for current call
  2511.  
  2512.             *! : Freeze  the  system timer  for the duration of the
  2513.                  shell.  Useful for running external utilities like
  2514.                  full-screen chat programs etc.
  2515.  
  2516.             *# : Turn off the "Wants Chat" indicator on return     
  2517.                  from the shell. This is to facilitate proper      
  2518.                  installation of external chat utilities.
  2519.  
  2520.             *0 : The full path to the currently selected file      
  2521.                  template area.
  2522.  
  2523.             *1 : The number of the currently selected template     
  2524.                  message area.
  2525.  
  2526.  
  2527.        In  addition  to this command line information that  can  be
  2528.        passed,  RemoteAccess also creates two data files before the
  2529.        shell.  DORINFO1.DEF,  which is a RBBS-compatible file,  and
  2530.        EXITINFO.BBS,  which  contains  an  extremely  comprehensive
  2531.        amount of system and user information. The structure of this
  2532.        file  can be found in the RemoteAccess structures  document,
  2533.        RASTRUCT.  It should also be noted that ALL system files are
  2534.        written  to  and closed off before the shell  is  activated,
  2535.        then  reopened  and scanned upon  return.  This  means  that
  2536.        programs  that  modify system files (eg.  USERS.BBS) can  be
  2537.        safely run in a type 7 shell.
  2538.  
  2539.        RemoteAccess also supports Doorway's DOOR.SYS parameter file
  2540.        directly; including  a *D on  the command  line enables  the
  2541.        generation of this file.
  2542.  
  2543.        Note  that the external program must do it's own time  limit
  2544.        and  carrier watchdogging,  in the event that the user  does
  2545.        not exit from the program correctly.
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.                                     39
  2564.        Type          : 8
  2565.        Name          : Product information
  2566.        Optional Data : None
  2567.  
  2568.        Displays  product  information including the version  number
  2569.        and  copyright information.  If a user is on-line  remotely,
  2570.        the name and version of the FOSSIL in use is also displayed.
  2571.  
  2572.  
  2573.  
  2574.        Type          : 9
  2575.        Name          : Terminate the session
  2576.        Optional Data : None
  2577.  
  2578.        Displays  the GOODBYE.ASC/ANS text file and hangs up on  the
  2579.        user by dropping the DTR signal to the modem.  To this  end,
  2580.        make  sure  your  modem's  DTR line  is  not  "forced  high"
  2581.        continuously.
  2582.  
  2583.  
  2584.  
  2585.        Type          : 10
  2586.        Name          : System usage
  2587.        Optional Data : None
  2588.  
  2589.        Displays  a nicely  formatted full-screen autoscaling  graph
  2590.        that   depicts system usage  in terms of  percentage use per
  2591.        hour.  To reset  this graph,  delete the  file "TIMELOG.BBS"
  2592.        from your system directory.
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.                                     40
  2625.        Type          : 11
  2626.        Name          : Page sysop to chat
  2627.        Optional Data : <Paging string>
  2628.  
  2629.        Displays the <paging string> to the user and pages the sysop
  2630.        for a  chat.  If the REASON FOR PAGE option has been enabled
  2631.        in RACONFIG, RemoteAccess will display a user-defined prompt
  2632.        and  wait for  the user to  enter a reason  for requesting a
  2633.        chat. The sysop may select "C" to chat with the user, or "A"
  2634.        to abort the page.  You may break in for a  chat at any time
  2635.        by   pressing  ALT-C.   All sysop  keys are  listed in   the
  2636.        reference section of this manual.  During a chat, the system
  2637.        timer  is  "frozen",  and  is re-started when  the  chat  is
  2638.        terminated.  The sysop terminates chat mode with the  ESCape
  2639.        key.  During  chat,  you may open a capture file to log  the
  2640.        chat  session  by pressing CTRL-A,  and again to  close  the
  2641.        capture.
  2642.  
  2643.        The default paging sound is a  constant "beep-beep" tone for
  2644.        the duration of the page. You may define your own page sound
  2645.        by creating  a  text  file  called  PAGE.RA  in  the  system
  2646.        directory. The following keywords are valid:
  2647.  
  2648.  
  2649.          TONE [hz] [1/100's sec]   (sounds hz)
  2650.          WAIT [1/100's sec]        (sounds nothing)
  2651.  
  2652.  
  2653.        The following  table lists  several musical octaves  and the
  2654.        correct frequency value associated with each note:
  2655.  
  2656.  
  2657.          Note  Oct - 1    2    3    4    5    6
  2658.          ----        
  2659.          C       F   45  134 268  536 1071 2145
  2660.          C#      r   71  142 284  568 1136 2273
  2661.          D       e   75  150 301  602 1204 2408
  2662.          D#      q   80  159 319  638 1275 2551
  2663.          E       u   84  169 338  676 1351 2703
  2664.          F       e   90  179 358  716 1432 2864
  2665.          F#      n   95  190 379  758 1517 3034
  2666.          G       c   100 201 402  804 1607 3215
  2667.          G#      y   106 213 426  851 1703 3406
  2668.          A       #   113 225 451  902 1804 3608
  2669.          A#          119 239 478  956 1991 3823
  2670.          B           127 253 506 1012 2025 4050
  2671.  
  2672.  
  2673.        The  RemoteAccess distribution  archive  contains  a  sample
  2674.        PAGE.RA file to get you started.
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.                                     41
  2686.        Type          : 12
  2687.        Name          : Questionnaire
  2688.        Optional Data : <1-8 character file name> [/N]
  2689.  
  2690.        Initiates a questionnaire. The <file name> is the first part
  2691.        of  the  name of the questionnaire file.  All  questionnaire
  2692.        files  are stored in the system directory,  and have a  name
  2693.        extension of .Q-A.  User's responses are stored in an output
  2694.        file  named  <file name>.ASW.  There is a full  tutorial  on
  2695.        questionnaires,   including  the  script  language  in   the
  2696.        reference section of this manual.
  2697.  
  2698.        RemoteAccess has two hard-coded questionnaires.  If present,
  2699.        it will   initiate the  questionnaire NEWUSER.Q-A for  a new
  2700.        user after   the   hard-coded  text  file   NEWUSER2.ASC/ANS
  2701.         is displayed.  
  2702.  
  2703.        The  SUBDATE.Q-A  questionnaire  is automatically  initiated
  2704.        when  a  user  logs on  and  his/her  subscription date  has
  2705.        expired.  You  could  use  this  questionnaire  to  possibly
  2706.        downgrade  the  user's  security and/or  flag  settings  and
  2707.        display   a  message   informing   the  user   that  his/her
  2708.        subscription has expired.
  2709.  
  2710.        For  information on  hard-coded  (external  support)  files,
  2711.        refer to the EXTERNAL SUPPORT FILES section.
  2712.  
  2713.        Normally the initiation of  a questionnaire is noted  in the
  2714.        system log. Placing the /N parameter after the questionnaire
  2715.        name on the optional data line will suppress this log entry.
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.                                     42
  2747.        Type          : 13
  2748.        Name          : User listing
  2749.        Optional Data : [/G]
  2750.  
  2751.        Displays a list of users in the user file. Lists users name,
  2752.        location,  file ratio,  and the last time he/she called  the
  2753.        system.  This  function  has  some  basic  pattern  matching
  2754.        capabilities  on the  name field.  By default all  users are
  2755.        listed. However, if a  /G is specified in the  optional data
  2756.        field then the user will only see users who are  in the same
  2757.        group.  Note that  this  restriction does  not apply  to the
  2758.        sysop.
  2759.  
  2760.  
  2761.  
  2762.        Type          : 14
  2763.        Name          : Time
  2764.        Optional Data : None
  2765.  
  2766.        Shows the current date and time, along with the user's daily
  2767.        time limit, time used and time remaining for the day.
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.  
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.                                     43
  2808.        Type          : 15
  2809.        Name          : Exit to DOS
  2810.        Optional Data : <Errorlevel>
  2811.  
  2812.        This  function  causes RemoteAccess exit to the  batch  file
  2813.        that  executed  it,  with  a specific  errorlevel.  Set  the
  2814.        optional  data  to the errorlevel you wish to  pass  to  the
  2815.        batch  file.  The batch file should trap the errorlevel  and
  2816.        act  accordingly.  If  you exit while the user is still  on-
  2817.        line, to log the user back on invoke RemoteAccess with the -
  2818.        R  command line parameter.  This will force it to  read  the
  2819.        EXITINFO  file that was written at the time of the  previous
  2820.        exit  and take the user directly to the top menu.  Note that
  2821.        errorlevels  0 to 5 are reserved by RemoteAccess for  system
  2822.        use (see the reference section on ERRORLEVELS for a complete
  2823.        list  and  description of these and how to  use  them),  and
  2824.        should not be used.
  2825.  
  2826.        There are two control  codes that are valid on  the optional
  2827.        data field:
  2828.  
  2829.             *A : Pass the user's handle/alias in DORINFO.DEF
  2830.             *D : Generate the DOOR.SYS file 
  2831.  
  2832.        See  the  description  of  the  menu  command  type  7   for
  2833.        additional information on both of these options.
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.                                     44
  2869.        Type          : 16
  2870.        Name          : Alter location
  2871.        Optional Data : None
  2872.  
  2873.        Allows  the user to change the "location" field  in  his/her
  2874.        user record.
  2875.  
  2876.  
  2877.  
  2878.        Type          : 17
  2879.        Name          : Alter password
  2880.        Optional Data : None
  2881.  
  2882.        Allows  the  user  to  change  his/her  password.   Frequent
  2883.        password  changes  should  be encouraged  to  ensure  system
  2884.        security,  and  in fact there is an option to force a change
  2885.        of   password   every  certain  number  logons   (refer   to
  2886.        "RACONFIG").
  2887.  
  2888.  
  2889.  
  2890.        Type          : 18
  2891.        Name          : Alter screen length
  2892.        Optional Data : None
  2893.  
  2894.        Allows  the  user  to alter the  length  of  his/her  screen
  2895.        display. This affects the "Continue?" prompt.
  2896.  
  2897.  
  2898.  
  2899.        Type          : 19
  2900.        Name          : Toggle screen clearing
  2901.        Optional Data : None
  2902.  
  2903.        Allows  the user to specify whether he/she would like screen
  2904.        clearing codes sent.
  2905.  
  2906.  
  2907.  
  2908.        Type          : 20
  2909.        Name          : Toggle page pausing
  2910.        Optional Data : None
  2911.  
  2912.        Allows the user to enable or disable the "Continue?"  prompt
  2913.        at the end of each screen page.
  2914.  
  2915.  
  2916.  
  2917.        Type          : 21
  2918.        Name          : Toggle ANSI graphics
  2919.        Optional Data : None
  2920.  
  2921.        Allows the user to select, or deselect ANSI graphics. If the
  2922.        user disables ANSI, use of the full screen message editor is
  2923.        also disabled. 
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.                                     45
  2930.        Type          : 22
  2931.        Name          : Check the mailbox
  2932.        Optional Data : None
  2933.  
  2934.        Checks  to  see if there is any mail addressed to  the  user
  2935.        that he/she hasn't yet read.  This can be done automatically
  2936.        at log-on by setting the appropriate option in RACONFIG. See
  2937.        the section on configuration for details of the two types of
  2938.        mail-check available.  All new messages are marked for later
  2939.        retrieval with the "Read Marked" option.  Note that the user
  2940.        will  only be notified of mail in areas that he/she has read
  2941.        access to,  as defined in RACONFIG. Although the system only
  2942.        prompts  the  user with a "Read mail now  [Yes/no]"  prompt,
  2943.        several options can be activated.  Valid choices are [R]ead,
  2944.        [S]can, [Q]uickscan, [K]ill, or [M]ark as received.
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.  
  2978.  
  2979.  
  2980.  
  2981.  
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.                                     46
  2991.        Type          : 23
  2992.        Name          : Read messages
  2993.        Optional Data : <Message area #> or /M
  2994.  
  2995.        Initiates the message reading routines. Checks that the user
  2996.        has  read  access to the message area first.  The  user  may
  2997.        select several different scan modes.  These include forward,
  2998.        reverse,  new messages, marked messages, individual message,
  2999.        or  a  selected  scan according to  the  "To:",  "From:"  or
  3000.        "Subject"  fields.  Online help is also available from  this
  3001.        hard-coded menu in the form of a text file.  Put the message
  3002.        area  number  on the optional data field,  or  0  to  select
  3003.        "combined"  mode  (see  function type 28 for  more  on  this
  3004.        feature).  If  you put a "/M" in the optional data field  in
  3005.        place  of the area number,  RemoteAccess will  automatically
  3006.        substitute the currently selected template message area into
  3007.        the  data field.  See MENU TEMPLATES for more on  this.  The
  3008.        message area number refers to number assigned to the desired
  3009.        area in RACONFIG.
  3010.  
  3011.        The  menu  bar  at the  end  of  each  message provides  the
  3012.        following functions:
  3013.  
  3014.        [-] : Read previous reply
  3015.        [+] : Read next reply
  3016.        [A] : Redisplay message again
  3017.        [N] : Go to the next message
  3018.        [L] : Go back to the previous message
  3019.        [R] : Post a reply to the current message
  3020.        [E] : Enter a new message in the current area
  3021.        [F] : Download files that are attached to the message
  3022.        [D] : Delete the displayed message (check the "delete msg"  
  3023.              menu function for more information)
  3024.        [S] : Stop reading messages
  3025.  
  3026.        The following options  are available only to  users who have
  3027.        sysop access to the message area:
  3028.  
  3029.        [!] : Display ^A kludge lines normally hidden
  3030.        [*] : Edit the current message's attributes
  3031.        [X] : Export message to a file or the printer
  3032.        [/] : Forward message to another user in any area
  3033.        [=] : Mark message as unreceived and go to the next message
  3034.        [U] : Modify the security level of the user who posted the  
  3035.              currently displayed message, provided the user is     
  3036.              listed in the userfile. Great for "on the fly" user   
  3037.              verification! {+} Only available in registered        
  3038.              version.
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.                                     47
  3052.        Type          : 24
  3053.        Name          : Scan messages
  3054.        Optional Data : <Message area #> or /M
  3055.  
  3056.        Same  as  the  READ  message function  (type  23)  but  only
  3057.        displays  the message header of each message.  The user also
  3058.        has the option of marking messages for later retrieval.
  3059.  
  3060.  
  3061.  
  3062.        Type          : 25
  3063.        Name          : QuickScan messages
  3064.        Optional Data : <Message area #> or /M
  3065.  
  3066.        Same as the READ message function (type 23) but each message
  3067.        is listed as a single-line entry containing message  number,
  3068.        the poster of the message,  who it is addressed to,  and the
  3069.        subject line.
  3070.  
  3071.  
  3072.  
  3073.        Type          : 26
  3074.        Name          : Delete message
  3075.        Optional Data : None
  3076.  
  3077.        Allows a user to delete a message provided that:
  3078.  
  3079.        * The user has sysop access to the area the message is in,  
  3080.          OR
  3081.  
  3082.        * The message is in a LOCAL or NETMAIL area and the user is 
  3083.          the sender or recipient of the message, OR
  3084.  
  3085.        * The message is in an echomail area and the user is the    
  3086.          sender of the message, provided the message has not been  
  3087.          exported from the message-base.
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.                                     48
  3113.        Type          : 27
  3114.        Name          : Post message
  3115.        Optional Data : <Message Area #> or /M [/L] [/T=<Name>]
  3116.  
  3117.        Post  a  message  in the specified area  (or  the  currently
  3118.        selected  template area if the "/M" is used).  The user must
  3119.        have  either write or sysop access to the message  area,  as
  3120.        defined  in RACONFIG.  The /L option will log the  user  off
  3121.        immediately  after the message is saved (useful for a "Leave
  3122.        message  to  sysop before disconnecting"  option).  The  /T=
  3123.        option will force the message to be addressed to a  specific
  3124.        user.  Simply  place  the user's name in the  optional  data
  3125.        field  after  the /T= parameter to select this  option.  For
  3126.        example, on my "log-off" menu, I have the following entry:
  3127.  
  3128.        Menu Type 27
  3129.        Optional Data: 60 /L /T=Andrew_Milner
  3130.  
  3131.        (Any messages to "Sysop" are redirected to the sysop's  name
  3132.        as defined in RACONFIG).  If you do use a full name, be sure
  3133.        to use underscores in place of spaces.
  3134.  
  3135.        Specifying a message area number of zero forces RemoteAccess
  3136.        to  display all message areas that the user has write access
  3137.        to and prompt for the message area to post the message in.
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.                                     49
  3174.        Type          : 28
  3175.        Name          : Select combined areas
  3176.        Optional Data : None
  3177.  
  3178.        Allows  the user to select any combination of message  areas
  3179.        for  "combined" mode message reading/scanning/quickscanning.
  3180.  
  3181.        The  user is shown a list of available areas and may  toggle
  3182.        any  of  them "ON" or "OFF".  This combination of  areas  is
  3183.        saved  as part of the user's permanent user record,  and  is
  3184.        restored at next log on.  To read messages on the "combined"
  3185.        area, use a normal read/scan/quickscan menu function but set
  3186.        the message area number in the optional data field to  zero.
  3187.  
  3188.        Area  zero is hard-coded as this combined area and cannot be
  3189.        defined by the sysop. Note that it is possible to define via
  3190.        RACONFIG a  default selection of combined  message areas for
  3191.        new users.
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.                                     50
  3235.        Type          : 29
  3236.        Name          : Move a file
  3237.        Optional Data : <Full source path>
  3238.  
  3239.        Primarily intended as a sysop/assistant sysop function, this
  3240.        allows  the  user  to move files  from  a  pre-defined  area
  3241.        <source-path>  to  any valid DOS directory without the  need
  3242.        for remote access  to DOS.  After the file  has been  copied
  3243.        successfully,  RemoteAccess will optionally  move the file's
  3244.        description (if there is one) to the destination directory.
  3245.  
  3246.  
  3247.  
  3248.        Type          : 30
  3249.        Name          : Directory
  3250.        Optional Data : <Full path> or /F
  3251.  
  3252.        Displays   an  MS-DOS  style  directory  of  the   directory
  3253.        specified in the optional data field,  showing name,  length
  3254.        and date of each  file. The user is prompted for an optional
  3255.        wildcard / pattern match filespec.
  3256.  
  3257.  
  3258.  
  3259.        Type          : 31
  3260.        Name          : List files
  3261.        Optional Data : <Full path> or /F
  3262.  
  3263.        This option displays a list of files available for  download
  3264.        from  the  directory  specified  by the  path  name  in  the
  3265.        optional  data  field.  The file names and descriptions  are
  3266.        contained  in  a  file  called  FILES.BBS.   This  file   is
  3267.        automatically  maintained  by  RemoteAccess when  files  are
  3268.        uploaded,  but it may also be edited by the sysop.  The file
  3269.        consists  of  a  single  word  file-name  per  line  with  a
  3270.        description,  up to 255 characters in  length.  Descriptions
  3271.        that  exceed  the  width  of the  screen  are  automatically
  3272.        wrapped to the next line. The upload date and length of each
  3273.        file is also displayed (optionally),  and an asterisk before
  3274.        the  description  signifies that the file is new  since  the
  3275.        user's last call.
  3276.  
  3277.        If,  instead  of the full path to the file area,  you put  a
  3278.        "/F",  RemoteAccess  will  substitute  the  path  name  that
  3279.        corresponds to the currently selected template file area, as
  3280.        defined  in  RACONFIG.  See the MENU  TEMPLATE  section  for
  3281.        further information on this.
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.                                     51
  3296.        Type          : 32
  3297.        Name          : Download a file from area
  3298.        Optional Data : <Full path> or /F [Password]
  3299.  
  3300.        Enables  the user to download any file that is contained  in
  3301.        the  specified  directory.  Note that the file need  not  be
  3302.        listed in that directory's FILES.BBS for the user to be able
  3303.        to download it. If a password is specified, the user will be
  3304.        asked for a non case-sensitive password before being allowed
  3305.        to  proceed  with the transfer.  The /F option works in  the
  3306.        same way as in function 31. 
  3307.  
  3308.                         
  3309.  
  3310.  
  3311.        Type          : 33
  3312.        Name          : Upload a file
  3313.        Optional Data : <Full path> or /F
  3314.  
  3315.        Enables the user to upload (send) a file to your system. The
  3316.        file  will  be  placed in the  directory  specified  in  the
  3317.        optional data path.  FILES.BBS will be automatically updated
  3318.        to reflect the upload.  The /F option works in the same  way
  3319.        as in function 31 and 32.
  3320.  
  3321.  
  3322.  
  3323.        Type          : 34
  3324.        Name          : View archive
  3325.        Optional Data : <Full path> or /F
  3326.  
  3327.        Allows  the user to view the contents of an archived file in
  3328.        the specified directory. At present, only ZIP and LZH  files
  3329.        are supported, but this will be expanded in the future. Menu
  3330.        templating   is  supported  with the  /F  option.   This  is
  3331.        explained more fully in MENU TEMPLATES.
  3332.  
  3333.  
  3334.  
  3335.        Type          : 35
  3336.        Name          : File scan by keyword
  3337.        Optional Data : [area1 area2 area3 ...]
  3338.  
  3339.        This function uses the data specified in RACONFIG to  search
  3340.        all  file  areas that the user has access to for a  key-word
  3341.        that  is supplied by the user.  Any FILES.BBS  entries  that
  3342.        match  are displayed with the name of the area the match was
  3343.        found in.  The default  is to  scan all  areas, but  you may
  3344.        specify  that only certain areas  be searched by putting the
  3345.        area numbers to include on the optional data line.
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.                                     52
  3357.        Type          : 36
  3358.        Name          : File scan by file name
  3359.        Optional Data : [area1 area2 area3 ...]
  3360.  
  3361.        Same as function 35, but scans for an exact file name match.
  3362.        Wildcard and  pattern  matching characters  are  valid.  The
  3363.        default is to scan all areas, but you may specify that  only
  3364.        certain  areas be  searched by  putting the area  numbers to
  3365.        include on the optional data line.
  3366.  
  3367.  
  3368.  
  3369.        Type          : 37
  3370.        Name          : Show new files
  3371.        Optional Data : [area1 area2 area3 ...]
  3372.  
  3373.        Scans  all file areas that the user has access to for  files
  3374.        that   have  a date  more recent than the  date specified by
  3375.        the user. The default is  to search for files new  since the
  3376.        users last log-on. The default is to scan all areas, but you
  3377.        may specify that  only certain areas be searched  by putting
  3378.        the area numbers to include on the optional data line.
  3379.  
  3380.  
  3381.  
  3382.        Type          : 38
  3383.        Name          : Type (view) a text file
  3384.        Optional Data : <Full path> or /F
  3385.  
  3386.        Allows  the  user to type to the terminal the contents of  a
  3387.        plain ASCII/ANSI text file in the specified directory.  This
  3388.        is useful for on-line file lists or magazines. The /F option
  3389.        overrides the path name with the currently selected template
  3390.        file area path.
  3391.  
  3392.  
  3393.  
  3394.        Type          : 39
  3395.        Name          : Display a fully named text file
  3396.        Optional Data : <Full path and name>
  3397.  
  3398.        Similar  to the type 5 function,  but allows you to  specify
  3399.        the  full  path and name (including extension) of  the  file
  3400.        that will be displayed.  Like the type 5 function, this also
  3401.        interprets the special control characters.
  3402.  
  3403.  
  3404.  
  3405.        Type          : 40
  3406.        Name          : Display an ASC/ANS text file with hot keys
  3407.        Optional Data : <1-8 character name>
  3408.  
  3409.        Displays  an  ASC/ANS  text file the same way as  a  type  5
  3410.        would, but leaves the current menu hot keys active while the
  3411.        file is displayed. This allows the use of elaborate graphics
  3412.        in  your menus that would be impossible to create  with  the
  3413.        line  editor.  See  also  AUTOMATIC  COMMAND  EXECUTION  for
  3414.        details on how to integrate these files into your menus.
  3415.  
  3416.  
  3417.                                     53
  3418.        Type          : 41
  3419.        Name          : Toggle full screen editor
  3420.        Optional Data : None
  3421.  
  3422.        Allows  the  user to select or deselect the use of the  full
  3423.        screen message editor.  Use of the editor is only  permitted
  3424.        if the user has ANSI graphics enabled.
  3425.  
  3426.  
  3427.  
  3428.        Type          : 42
  3429.        Name          : Toggle hot-keys
  3430.        Optional Data : None
  3431.  
  3432.        Allows  the  user  to choose  between  hot-keys  or  command
  3433.        stacking.  In  command stacking mode,  several commands,  or
  3434.        key-presses, can be specified on one command line by putting
  3435.        a semi-colon in between each command.
  3436.  
  3437.  
  3438.  
  3439.        Type          : 43
  3440.        Name          : NewMail {+}
  3441.        Optional Data : None
  3442.  
  3443.        Display a  full list of all  the message areas the  user has
  3444.        read  access  to,  highlighting  those  that contain  unread
  3445.        messages. This menu command  is available only in registered
  3446.        only mode.
  3447.  
  3448.  
  3449.  
  3450.        Type          : 44
  3451.        Name          : Reset combined areas setting
  3452.        Optional Data : None
  3453.  
  3454.        Allows  the user turn ON or OFF all available message  areas
  3455.        for his/her combined message area setting.
  3456.  
  3457.  
  3458.  
  3459.        Type          : 45
  3460.        Name          : Display text file and wait
  3461.        Optional Data : <1-8 character name>
  3462.  
  3463.        This is the same as a type 5 function,  but prompts the user
  3464.        to  press  [Return] before continuing.  This is  useful  for
  3465.        displaying  text  files that are generated automatically  by
  3466.        utilities that don't append a Control-A (wait character)  at
  3467.        the end of the file.
  3468.  
  3469.  
  3470.  
  3471.        Type           : 46
  3472.        Name           : Display direct textfile with CR
  3473.        Optional Data  : <Full path and name>
  3474.  
  3475.        Displays  a text file with  a fully qualified  path and name
  3476.        and waits for the user to press [Return] before continuing.
  3477.  
  3478.                                     54
  3479.        Type          : 47
  3480.        Name          : Make a log entry
  3481.        Optional Data : <Log entry>
  3482.  
  3483.        When this command is executed,  it simply takes the contents
  3484.        of  the Optional Data field and writes it to the system  log
  3485.        as if it were a normal hard-coded log entry. The only  macro
  3486.        characters that are valid are:
  3487.  
  3488.             @ : Insert the name of the current template file area
  3489.             ` : Insert the name of the current template msg area
  3490.  
  3491.  
  3492.  
  3493.        Type          : 48
  3494.        Name          : Download a specific file
  3495.        Optional Data : <Full path and name>
  3496.  
  3497.        Enables the user to download a file or set of files that you
  3498.        have  pre-defined,  using  a protocol of the user's  choice.
  3499.        Note  that  you  may specify wild-cards  and  pattern  match
  3500.        characters in the file name, but if you do, the user will be
  3501.        forced to use a batch transfer protocol. For example, a type
  3502.        48 command with the following optional data field:
  3503.  
  3504.             C:\FILES\RA\RELEASE\RA*.ZIP
  3505.  
  3506.        Would  send all files in the  C:\FILES\RA\RELEASE  directory
  3507.        that matched RA*.ZIP.
  3508.  
  3509.  
  3510.  
  3511.        Type          : 49
  3512.        Name          : Select message area
  3513.        Optional Data : None
  3514.  
  3515.        Displays  a  list of  all message  areas  the user  has read
  3516.        access to, and  asks the user to  select one by number.  The
  3517.        current message  template area  number is set  to the  users
  3518.        choice.  This allows the sysop to run a very low maintenance
  3519.        system,  since all  that  is required  to  add or  delete  a
  3520.        message  area  is  to  modify  the  configuration  file  via
  3521.        RACONFIG.
  3522.  
  3523.  
  3524.  
  3525.        Type          : 50
  3526.        Name          : Select file area
  3527.        Optional Data : None
  3528.  
  3529.        This operates in the  same way as the "select  message area"
  3530.        (type 49)  menu function,  but  uses file  areas instead  of
  3531.        message areas.
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.                                     55
  3540.        Type          : 51
  3541.        Name          : List today's callers
  3542.        Optional Data : None
  3543.  
  3544.        Lists  every  caller  that  has  called  your  system  since
  3545.        midnight  along with log on/off times,  baud rate  and  what
  3546.        line the call was taken on.
  3547.  
  3548.  
  3549.  
  3550.        Type          : 52
  3551.        Name          : Show all users on-line
  3552.        Optional Data : None
  3553.  
  3554.        Lists all users currently on-line. This would only be useful
  3555.        in a multi-line installation.  It shows where each caller is
  3556.        calling   from,  their   baud   rate, the   line  they   are
  3557.        connected to and what they are doing.
  3558.  
  3559.  
  3560.  
  3561.        Type          : 53
  3562.        Name          : Toggle "Do not disturb"
  3563.        Optional Data : None
  3564.  
  3565.        This  another  multi-line feature only.  It allows the  user
  3566.        turn  on or off the ability of other users to  send  him/her
  3567.        messages  whith  the type 54 function,  like - "Hey  Joe,  I
  3568.        noticed  that you're on line 3.  Wanna chat?" Note that  the
  3569.        sysop  has the ability to override this and send  a  message
  3570.        anyway.
  3571.  
  3572.  
  3573.  
  3574.        Type          : 54
  3575.        Name          : Send an on-line message
  3576.        Optional Data : None
  3577.  
  3578.        Allows  the  user to send a message to another user  who  is
  3579.        logged on to  another line at the same time.  Provided  that
  3580.        the  other  user has not set his/her "do not disturb"  flag,
  3581.        the  sender  will be prompted for a one-liner  to  transmit.
  3582.  
  3583.        Depending on what the recipient is doing at the time, he/she
  3584.        will get the message ten to fifteen seconds later.
  3585.  
  3586.  
  3587.  
  3588.        Type          : 55
  3589.        Name          : Download any file
  3590.        Optional Data : None
  3591.  
  3592.        This  is an extremely powerful function that should be  only
  3593.        accessible  by the sysop.  It allows the user to download  a
  3594.        file  from  any  valid drive or directory using any  of  the
  3595.        available file transfer protocols.  Note that this the  ONLY
  3596.        download  function that takes no account of download limits,
  3597.        file ratios or transfer time,  and does not update the users
  3598.        record to reflect the download.
  3599.  
  3600.                                     56
  3601.        Type           : 56
  3602.        Name           : Browse the nodelist {+}
  3603.        Optional Data  : None
  3604.  
  3605.        Allows the  user to browse the  nodelist. Includes functions
  3606.        to list  all zones, list all nets and regions in a zone, and
  3607.        list all nodes in a net or region.
  3608.  
  3609.  
  3610.  
  3611.        Type           : 57
  3612.        Name           : Change home/voice number
  3613.        Optional Data  : None
  3614.  
  3615.        Allows the  user to  modify his/her home/voice  phone number
  3616.        permanently.
  3617.  
  3618.  
  3619.  
  3620.        Type           : 58
  3621.        Name           : Change business/data number
  3622.        Optional Data  : None
  3623.  
  3624.        Allows the user to modify his/her business/data phone number
  3625.        permanently.
  3626.  
  3627.  
  3628.  
  3629.        Type           : 59
  3630.        Name           : Global download {+}
  3631.        Optional Data  : None
  3632.  
  3633.        Allows  the  user  to download  files  as  per  the type  32
  3634.        donwload command, but searches ALL areas the user has access
  3635.        to for  the requested  file(s). All  normal  time and  other
  3636.        security restrictions apply.
  3637.  
  3638.  
  3639.  
  3640.        Type           : 60
  3641.        Name           : Change handle
  3642.        Optional Data  : None
  3643.  
  3644.        Allows  the user to  select a new handle.  Note that it will
  3645.        not  allow the  user to  choose a  name which  is in  use by
  3646.        another user. It will also not allow the use of "SYSOP" as a
  3647.        handle.
  3648.  
  3649.  
  3650.  
  3651.        Type           : 61
  3652.        Name           : Toggle AVATAR
  3653.        Optional Data  : None
  3654.  
  3655.        Toggles the use of AVATAR codes (see the section on TERMINAL
  3656.        EMULATIONS for more information).
  3657.  
  3658.  
  3659.  
  3660.  
  3661.                                     57
  3662.        Type           : 62
  3663.        Name           : Toggle full screen message viewer
  3664.        Optional Data  : None
  3665.  
  3666.        Allows the user  to select  or deselect of  the full  screen
  3667.        message  presentation  manager.  When  active,  this  option
  3668.        displays  all messages with a fixed header and uses ANSI and
  3669.        AVATAR codes for special screen manipulation.
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.  
  3704.  
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.  
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.  
  3717.  
  3718.  
  3719.  
  3720.  
  3721.  
  3722.                                     58
  3723.        Automatic command execution                            
  3724.        ────────────────────────────────────────────────────────────
  3725.  
  3726.        Normally  a  menu  function would be activated when  a  user
  3727.        presses  the  key  that you have linked  to  that  function.
  3728.        However,  it is possible to cause a function to be  executed
  3729.        automatically  as soon as a menu is displayed by setting the
  3730.        entry to "auto execute". As  soon as that  particular  menu 
  3731.        line    is     displayed  the     function    is    executed
  3732.        automatically,  without the need for the user to select  the
  3733.        option.  This  is a very powerful feature when used with the
  3734.        type  40 menu function,  which displays an  ASCII/ANSI  text
  3735.        file  while  checking for menu hot-keys.  By setting up  the
  3736.        first line of a menu as a type 40 with automatic  execution,
  3737.        as  soon  as the menu is called your text file is  displayed
  3738.        instead of the normal menu lines.  This allows you to design
  3739.        very  elaborate graphical menu displays that  contain  extra
  3740.        information  about  the user by inserting the  special  text
  3741.        file control codes.  What happens if a user "passes through"
  3742.        a  menu by using a stacked menu command?  In some cases  you
  3743.        may  want the automatic command to execute,  for example  to
  3744.        redirect  the user to another menu by automatic execution of
  3745.        a type 1 or 2. On the other hand, if the command is only for
  3746.        cosmetic  purposes (maybe a text file to display  some  user
  3747.        statistics)  it  would  be better to skip  the  command  and
  3748.        continue   straight to the next  menu. The rule is  that the
  3749.        menu command will only be executed if  it is the first entry
  3750.        in  the menu  AND  it  is  not  a  'display  textfile'  type
  3751.        function. 
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.        Special optional data switches
  3758.        ────────────────────────────────────────────────────────────
  3759.  
  3760.        There  are two special "switches" which may be placed at the
  3761.        end of the optional data field for any menu command:
  3762.  
  3763.        /NS    : This switch suppresses the usual clear screen code 
  3764.                 that RemoteAccess sends when a new menu is         
  3765.                 displayed, and is only useful when used with a menu
  3766.                 navigation (GOTO, GOSUB etc) command.
  3767.  
  3768.        /K=xxx : {+} Registered only. This switch places the        
  3769.                 specified text <xxx> into the user's input buffer  
  3770.                 to be processed exactly as if it had been entered  
  3771.                 as a stacked command. This is an extremely powerful
  3772.                 facility which can be used to link a number of menu
  3773.                 commands together, and customise a large number of 
  3774.                 hard-coded selection menus.
  3775.  
  3776.  
  3777.  
  3778.  
  3779.  
  3780.  
  3781.  
  3782.  
  3783.                                     59
  3784.        Menu templates                      
  3785.        ────────────────────────────────────────────────────────────
  3786.  
  3787.        The  biggest  drawback of other BBS packages that allow  the
  3788.        sysop  the flexibility of designing his or her own menus  is
  3789.        the amount of maintenance that is necessary in updating  the
  3790.        menus.  Until  now it was necessary to have a separate  menu
  3791.        for  each  file  and message  area.  The  RemoteAccess  menu
  3792.        templating system alleviates this problem by allowing you to
  3793.        set  up one menu that will act as a "skeleton" for all  your
  3794.        message  and  file areas.  Two "variables" are available  to
  3795.        you; "M" for the currently selected message area and "F" for
  3796.        the currently selected file area.  In your template menu(s),
  3797.        where you would normally put the message area number in  the
  3798.        optional  data field for say a "Read" command,  put in "/M".
  3799.  
  3800.        When  the read is selected by the  user,  RemoteAccess  will
  3801.        substitute this for a message area number.  Likewise,  where
  3802.        you would specify a full path for a file function, put a "/F
  3803.        in  the optional data field.  RemoteAccess will replace this
  3804.        variable with the path to the currently selected file area.
  3805.  
  3806.        To put a value into one of these two variables, simply put a
  3807.        "/M=<Area  Number>"  or "/F=<Area Number>" in  the  optional
  3808.        data field of a type 1,  2 or 4 menu command.  For  example,
  3809.        say   you  set  up  a  message  area  template  menu  called
  3810.        "MSGMENU", using the /M in the optional data fields. Another
  3811.        menu,  which  you have set up to list the available  message
  3812.        areas,  simply consists of type 1 or 2 menu commands to jump
  3813.        to MSGMENU. One menu line looks like this:
  3814.  
  3815.             <H>ard Disk Conference
  3816.  
  3817.        This is a type 2 command,  which will "gosub" to the MSGMENU
  3818.        menu:
  3819.  
  3820.             Type : 2
  3821.  
  3822.        On the optional data line,  put the name of the menu to jump
  3823.        to, and also set the template variable.
  3824.  
  3825.             Optional Data : MSGMENU /M=45
  3826.  
  3827.        45 corresponds to the hard disk conference area,  as defined
  3828.        in RACONFIG.
  3829.  
  3830.        There  are two other constructs that work with the  template
  3831.        commands. /M=+ or /F=+ will increment the currently selected
  3832.        template area  by one, and /M=- or /F=- will  decrement  the
  3833.        currently  selected template area by one.  RemoteAccess will
  3834.        automatically  scan  all  file (or  message)  areas  in  the
  3835.        specified direction to determine the next area that the user
  3836.        has been given access to.
  3837.  
  3838.  
  3839.  
  3840.  
  3841.  
  3842.  
  3843.  
  3844.                                     60
  3845.        When RemoteAccess fires up,  it scans both message  and file
  3846.        areas  and sets  each to  the first area  that the  user has
  3847.        access to. 
  3848.  
  3849.        There are a number of special characters that you can put in
  3850.        the display line of a menu which will display certain system
  3851.        information:
  3852.  
  3853.  
  3854.             ~  :  Displays time remaining today.
  3855.  
  3856.             ^  :  Switches between the normal line colours and  the
  3857.                   overall menu highlight colours. 
  3858.  
  3859.             ;  :  Don't display a carriage return / linefeed at the
  3860.                   end of the line.
  3861.  
  3862.             @  :  Displays the name (as defined in RACONFIG) of the
  3863.                   currently selected file template area.
  3864.  
  3865.             `  :  Displays the name (as defined in RACONFIG) of the
  3866.                   currently selected message template area.
  3867.  
  3868.  
  3869.  
  3870.  
  3871.  
  3872.        The global menu
  3873.        ────────────────────────────────────────────────────────────
  3874.  
  3875.        It is likely that there are some commands that you will want
  3876.        to  be available from every menu that the user sees. Instead
  3877.        of  duplicating these  for every  single menu,  simply place
  3878.        them by  themselves in a menu  called GLOBALRA. RemoteAccess
  3879.        searches   for  this   special  menu   and  if   it  exists,
  3880.        automatically appends it to the end of every menu.
  3881.  
  3882.        RemoteAccess  appends the  whole menu;  in other  words, not
  3883.        just  the commands but any  visible text as  well. Note that
  3884.        the global menu will always inherit the highlight colours of
  3885.        the current menu  it is  appended to. This  feature is  only
  3886.        available in the registered version.
  3887.  
  3888.  
  3889.  
  3890.  
  3891.  
  3892.  
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.  
  3899.  
  3900.  
  3901.  
  3902.  
  3903.  
  3904.  
  3905.                                     61
  3906.        Setting up your menus                      
  3907.        ────────────────────────────────────────────────────────────
  3908.  
  3909.        Spend  some  time thinking about how your menus will be  set
  3910.        up.  Your BBS can be made to look as unique or as  "uniform"
  3911.        as  you like - you can choose a subjective  topology,  where
  3912.        the  menus are organised according to area of interest, or a
  3913.        functional topology,  where menus are organised according to
  3914.        their  function.  For example,  a functional topology  would
  3915.        group  all  message  areas  together  and  all  file   areas
  3916.        together,  whereas a subjective topology would perhaps group
  3917.        together  several message and file areas that were  related.
  3918.  
  3919.        The  diagram  below illustrates this by depicting  the  same
  3920.        systems using the two different topologies:
  3921.  
  3922.        FUNCTIONAL
  3923.                                          +----------Amiga messages
  3924.                  +---------Messages menu |
  3925.                  |                       +----------IBM messages
  3926.        Main menu |
  3927.                  |                       +----------Amiga files
  3928.                  +------------Files menu |
  3929.                                          +----------IBM files
  3930.  
  3931.  
  3932.        SUBJECTIVE
  3933.                                          +----------IBM files
  3934.                  +--------------IBM menu | 
  3935.                  |                       +----------IBM messages
  3936.        Main menu |
  3937.                  |                       +----------Amiga files
  3938.                  +------------Amiga menu |
  3939.                                          +----------Amiga messages
  3940.  
  3941.  
  3942.        Alternatively,  you  could even use a combination of the two
  3943.        topology types.
  3944.  
  3945.        The  layout of your BBS is determined by how the  menus  are
  3946.        set up. In many cases a user will not realise that he or she
  3947.        is looking at a menu.  The best technique for creating menus
  3948.        is to create all the "low-level" menus first,  then the main
  3949.        menu, and then fill in between with the intermediate menus.
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.  
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.                                     62
  3967.        Creating your menus - RAMENU                               
  3968.        ────────────────────────────────────────────────────────────
  3969.  
  3970.        Change to the system directory and fire up RAMENU.EXE;  this
  3971.        is  the  utility  which allows you to create and  edit  your
  3972.        menus.  When  run  it will present you with a  directory  of
  3973.        menus  that have already been created - select one with  the
  3974.        cursor keys and press RETURN to edit, or simply press ESCAPE
  3975.        to create a new menu.
  3976.  
  3977.        A  large  window  is opened that displays  a  line  by  line
  3978.        summary  of the menu.  You may select a menu item to work on
  3979.        by moving the hilight bar to the item with the cursor  keys.
  3980.        The following keys are available:
  3981.  
  3982.  
  3983.        [RETURN]  - Edit the currently selected menu item.
  3984.  
  3985.        [INSERT]  - Insert  a new menu item immediately  before  the
  3986.                    current item.
  3987.  
  3988.        [DELETE]  - Delete the currently selected menu item.
  3989.  
  3990.        [ALT-D]   - Simulate  what  the menu  would look like  to  a
  3991.                    user.
  3992.  
  3993.        [ALT-P]   - View or modify the menu prompt,  its colour  and
  3994.                    the menu highlight colours.
  3995.  
  3996.        [ALT-S]   - Save the current menu to disk.
  3997.  
  3998.        [ALT-L]   - Discard  the present menu and load another  from
  3999.                    disk.
  4000.  
  4001.  
  4002.        Let's create the LOGOFF menu.  Hit RETURN on the first blank
  4003.        menu  item to bring up the EDIT MENU ITEM window.  The first
  4004.        line  of this menu will just display a message to the  user,
  4005.        so  in  the  USER DISPLAY field,  put "You  have  chosen  to
  4006.        disconnect.  You may -". Move to the ACTION field and set it
  4007.        to  DISPLAY  ONLY.  Next select a suitable  colour  for  the
  4008.        display  line  in  the COLOUR field.  Since this is  only  a
  4009.        display line,  leave SECURITY and FLAGS as they  are.  Press
  4010.        ESCAPE  to return to the menu list,  and note the entry  you
  4011.        have just created.
  4012.  
  4013.        Now enter the user options for the menu.  Move to the second
  4014.        menu  entry  (add one with the INSERT key if necessary)  and
  4015.        press  RETURN  to edit.  We'll give the user the  option  of
  4016.        leaving a message to the sysop, so in the USER DISPLAY field
  4017.        enter  "<L>eave a message to the sysop".  Set the ACTION  to
  4018.        POST  A NEW  MESSAGE (this is under the heading of  MESSAGE-
  4019.        BASE COMMANDS). This command requires a couple of parameters
  4020.        in the optional data field - the number of the message  area
  4021.        to  post the message in and the /T= parameter,  to force the
  4022.        message  to be addressed to the sysop.  It might  look  like
  4023.        this:
  4024.  
  4025.  
  4026.  
  4027.                                     63
  4028.        80 /T=Andrew_Milner
  4029.  
  4030.        (Message area 80 is set up as a "Messages to the sysop" area
  4031.        that  contains local private messages).  Set the HOT-KEY  to
  4032.        "L"  - this is the key that will activate the  function.  We
  4033.        want  all  users to be able to leave a message,  so set  the
  4034.        security level to 1.
  4035.  
  4036.        The  third  line of the menu gives the user  the  option  of
  4037.        returning  to  the previous menu,  so set this to a type  3,
  4038.        with a suitable display line.
  4039.  
  4040.        The  actual log-off command is last.  This will be a type  9
  4041.        (Terminate  Call).  Set the hot-key to "G" and  the  display
  4042.        line to something like "<G>oodbye (Logoff)".
  4043.  
  4044.        The  final step is to set the highlight and prompt  options.
  4045.        Press  ALT-P  from the menu list to bring up the  EDIT  MENU
  4046.        SETTINGS  window.  Here you can tailor the menu by selecting
  4047.        the  menu  prompt  and  its  colour,  along  with  the  menu
  4048.        highlight colour.  Each menu line,  in addition to it's  own
  4049.        colour,  may  contain an overall menu highlight  colour.  To
  4050.        switch between the two colours on a menu line, simply insert
  4051.        the  ^  character;  Note that this character isn't  actually
  4052.        displayed  to  the  user,   it  just  toggles  the  colours.
  4053.  
  4054.        Experiment with this feature by inserting a few ^ characters
  4055.        on display lines and viewing the menu with the ALT-D key.
  4056.  
  4057.        Finally,  save  the menu by going back to the menu list  and
  4058.        pressing  ALT-S.  Save the menu with the name  LOGOFF.  Now,
  4059.        whenever  you need a "Goodbye" option in another menu,  just
  4060.        use a gosub (type 2) function to the menu LOGOFF.
  4061.  
  4062.        There  is  one  hard-coded  menu  called  TOP.  RemoteAccess
  4063.        searches  for this menu when a user logs on and displays  it
  4064.        first,  so it MUST be present. The layout of the top menu is
  4065.        up to you of course;  it is recommended that you look at the
  4066.        menus of other Bulletin Boards so you can incorporate  their
  4067.        best features into your own.
  4068.  
  4069.  
  4070.  
  4071.  
  4072.  
  4073.  
  4074.  
  4075.  
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.                                     64
  4089.        EXTERNAL SUPPORT FILES   
  4090.        ────────────────────────────────────────────────────────────
  4091.                      
  4092.        There  is  very little that is  actually  "hard-coded"  into
  4093.        RemoteAccess. Below is a listing of text files you can place
  4094.        in  the  text  file directory to give your system  just  the
  4095.        right "feel". See the section on TEXT FILE CONTROL CODES for
  4096.        a  list  of special characters that can be used  to  display
  4097.        system  and user information from any of these files.  Files
  4098.        marked  with  an asterisk (*) have a default prompt  if  the
  4099.        file is missing. All the files are plain ASCII which you can
  4100.        create  with your favourite  text  editor/wordprocessor,  or
  4101.        optionally ANSI which you will need a special ANSI editor to
  4102.        create. See  the section on TERMINAL  EMULATIONS for further
  4103.        information.
  4104.  
  4105.  
  4106.  
  4107.        1ATATIME.A?? :  This file is displayed if a user tries to   
  4108.         *              log  on to more than one line at once  if   
  4109.                        multi-line check has been enabled in        
  4110.                        RACONFIG.
  4111.  
  4112.        BADFILES.A?? :  This file is displayed if the user attempts 
  4113.         *              to upload a file that is listed in          
  4114.                        BADFILES.CTL.
  4115.  
  4116.        BIRTHDAY.A?? :  This file is displayed if the current date  
  4117.                        is the same as the user's birthdate.
  4118.  
  4119.        DNLDHRS.A??  :  This  file is  displayed  if a  user        
  4120.         *              attempts a download outside the  allowed    
  4121.                        hours as defined in RACONFIG.
  4122.  
  4123.        EDITHELP.A?? :  This  file is displayed if the user asks for
  4124.                        help   while  using  the  built-in   message
  4125.                        editor.  
  4126.         
  4127.        ENDCHT.A??   :  This file is displayed when the sysop       
  4128.         *              terminates chat mode.
  4129.  
  4130.        EXPIRED.A??  :  This file is displayed if the user's        
  4131.         *              password has just expired, just before the  
  4132.                        user is asked for a new password.
  4133.  
  4134.        FILEAREA.A?? :  If present, this file will be displayed when
  4135.                        the user is asked to select a new file area 
  4136.                        in place of the normal hard-coded list.
  4137.  
  4138.        GOODBYE.A??  :  This file is displayed when the  user elects
  4139.                        to   log  off,   just  before  the  user  is
  4140.                        disconnected.
  4141.  
  4142.        HANDLE.A??   :  This file is displayed just before the user 
  4143.                        is asked to choose a new handle.
  4144.  
  4145.        LOCKOUT.A??  :  This file is displayed if the sysop uses    
  4146.         *              ALT-L  while a user is on-line to  lock     
  4147.                        him/her out of the system.
  4148.  
  4149.                                     65
  4150.        LOGO.ASC     :  This   file  is   displayed  as  soon  as  a
  4151.                        connection is made.  This should contain the
  4152.                        name  of your system and perhaps some  other
  4153.                        general information. 
  4154.  
  4155.        MAILHELP.A?? :  This file is displayed if the user asks for 
  4156.                        help at the mailbox scan prompt. Note that  
  4157.                        the user is only offered help if this file  
  4158.                        actually exists.
  4159.  
  4160.        MAXPAGE.A??  :  This  file  is displayed  if a user tries to
  4161.         *              page  the sysop for a chat more  times  than
  4162.                        you have specified in RACONFIG.
  4163.  
  4164.        MSGAREA.A??  :  If present, this file is displayed when the 
  4165.                        user is asked to select a message area in   
  4166.                        place of the normal hard-coded list.
  4167.  
  4168.        NEWS.A??     :  This file is a general news bulletin that is
  4169.                        displayed  after  RemoteAccess  checks   for
  4170.                        waiting mail (if the option is enabled),  or
  4171.                        straight after the WELCOME file.     
  4172.  
  4173.        NEWUSER1.ASC :  This file is displayed to a new user as soon
  4174.                        as  he/she  confirms  that  he/she   entered
  4175.                        his/her name correctly.
  4176.  
  4177.        NEWUSER2.A?? :  This  file  is displayed after the user  has
  4178.                        confirmed  that   he/she  entered  all   the
  4179.                        standard logon questions correctly.
  4180.  
  4181.        NO300.ASC    :  This file is  displayed if a 300 baud caller
  4182.         *              attempts  to log  on during hours  when  300
  4183.                        baud   is   not  allowed,   as  defined   in
  4184.                        RACONFIG.
  4185.  
  4186.        NOCREDIT.A?? :  This  file is displayed if a caller attempts
  4187.         *              to  enter a netmail message for which he/she
  4188.                        does not have sufficient credit.
  4189.  
  4190.        NOTAVAIL.A?? :  This  file  is displayed  if a user tries to
  4191.         *              page  the  sysop for a chat  outside  paging
  4192.                        hours, as defined in RACONFIG.
  4193.  
  4194.        NOTFOUND.ASC :  This   file  is  displayed  if  RemoteAccess
  4195.         *              cannot  locate the name of a user at  logon,
  4196.                        but before the user is asked to confirm that
  4197.                        he/she entered the name correctly.
  4198.  
  4199.        NOTSYSOP.A?? :  This file is displayed if a user attempts to
  4200.         *              post  a  message to "Sysop" in  an  EchoMail
  4201.                        message area.
  4202.  
  4203.        ONCEONLY.A?? :  This file is displayed just after the       
  4204.                        NEWS.A?? file only once whenever the file is
  4205.                        altered.
  4206.  
  4207.  
  4208.  
  4209.  
  4210.                                     66
  4211.        ALTNEWS.A??  :  This file is displayed ONLY if the NEWS.A?? 
  4212.                        file was not displayed to the user because  
  4213.                        he/she requested to skip it during an IEMSI 
  4214.                        session. If you want all users to see your  
  4215.                        news file regardless, simply copy NEWS.A??  
  4216.                        to ALTNEWS.A??.
  4217.  
  4218.        PAGEABRT.A?? :  This  file is displayed if the sysop chooses
  4219.         *              to abort a page for chat by the user.
  4220.  
  4221.        PAGED.A??    :  This  file is  displayed  after the user has
  4222.                        paged  for  a  chat if the  sysop  does  not
  4223.                        answer the page.  Something like "Okay,  the
  4224.                        sysop has been paged and will break in for a
  4225.                        chat if he/she walks past."
  4226.  
  4227.        PASSWORD.A?? :  This  file  is displayed before the user  is
  4228.                        asked  to select a new password.  This  file
  4229.                        should  stress the importance of choosing  a
  4230.                        suitable password!
  4231.  
  4232.        PRIVATE.ASC  :  This file  is displayed  if a new user tries
  4233.         *              to log on to your system and you have set it
  4234.                        up as a private, pre-register BBS. 
  4235.  
  4236.        RATIO.A??    :  This  file is displayed if the user tries to
  4237.         *              do  a  download which would  exceed  his/her
  4238.                        ratio of number of files.
  4239.  
  4240.        RATIOK.A??   :  This  file is displayed if the user tries to
  4241.         *              do  a  download which would  exceed  his/her
  4242.                        ratio of K of uploads to K of downloads.
  4243.  
  4244.        READHELP.A?? :  This  file is displayed if the user asks for
  4245.                        help while reading messages.
  4246.  
  4247.        SEC#.A??     :  These  files are  displayed  to users  of  a
  4248.                        particular security level directly after the
  4249.                        WELCOME file,  but before the mail check (if
  4250.                        enabled).     For    example,    the    file
  4251.                        SEC10.ASC/ANS,    if   present,   would   be
  4252.                        displayed  to all users with security  level
  4253.                        10. 
  4254.  
  4255.        STARTCHT.A?? :  This file is displayed when the sysop breaks
  4256.         *              in for a chat via ALT-C. Using the shell    
  4257.                        from textfile function this could           
  4258.                        conceivably be used to activate an external 
  4259.                        chat utility. See also ENDCHT.A??
  4260.  
  4261.        TIMEWARN.A?? :  This  file  is displayed  at log  on if  the
  4262.         *              user's  time  limit  has  been  adjusted  to
  4263.                        accomodate an upcoming event.
  4264.  
  4265.        TODAYK.A??   :  This  file is displayed if the user attempts
  4266.         *              a download which would exceed his/her  daily
  4267.                        download limit.
  4268.  
  4269.  
  4270.  
  4271.                                     67
  4272.        TOOSLOW.ASC  :  This  file  is displayed if a user tries  to
  4273.         *              log  on  at a speed lower than  the  minimum
  4274.                        required to log on to your system as defined
  4275.                        in RACONFIG. 
  4276.  
  4277.        TRASHCAN.ASC :  This  file  is displayed if a user enters an
  4278.         *              unacceptable  name at log on,  as listed  in
  4279.                        the TRASHCAN.CTL file. 
  4280.  
  4281.        WELCOME.A??  :  This file is displayed after the user logged
  4282.                        on,  or  in the case of a  new  user,  after
  4283.                        completing the new user procedure.  This can
  4284.                        be  a  fairly  elaborate title  screen  that
  4285.                        welcomes your users to the BBS.
  4286.  
  4287.        WELCOME1.A?? :  This file is  displayed  directly after  the
  4288.                        WELCOME file, and could contain extra system
  4289.                        information,   maybe  a  "today  in history"
  4290.                        quote, or something similar.
  4291.  
  4292.        XFERHELP.A?? :  This file is displayed if the user presses  
  4293.                        the "?" key on the file transfer protocol   
  4294.                        selection menu. It should contain general   
  4295.                        information about the different protocols   
  4296.                        themselves.
  4297.  
  4298.        XFERTIME.A?? :  This  file is displayed if the user attempts
  4299.         *              a  download that would exceed his/her  daily
  4300.                        time limit.
  4301.  
  4302.  
  4303.  
  4304.        In   addition to  these ASC/ANS files, there are a number of
  4305.        *.CTL  files  that  define various security aspects  of  the
  4306.        system:
  4307.  
  4308.          BADFILES.CTL : This file allows you to specify a list of  
  4309.                        files that users may not upload. Simply     
  4310.                        specify one file per line (wildcards valid),
  4311.                        for example:
  4312.  
  4313.                        *.GIF
  4314.                        NORTON*.*
  4315.  
  4316.                        Would not allow any files matching either of
  4317.                        these two patterns to be uploaded.
  4318.  
  4319.          FILES.CTL   : This file allows you to mark any            
  4320.                        downloadable file on your system as free    
  4321.                        and/or password protected. The format of    
  4322.          {+}           this file is:
  4323.          Registered
  4324.          Only          <filespec> [/FREE] [/PWD=xxx]
  4325.  
  4326.                        Example:
  4327.  
  4328.                        \RAFILES\RA_100.ZIP /FREE
  4329.                        \RABETAS\RABETA.ZIP /FREE /PWD=RACCESS
  4330.  
  4331.  
  4332.                                     68
  4333.                        Note that each filename must be fully       
  4334.                        qualified with a path (drive name optional).
  4335.  
  4336.                        Here, RA_100.ZIP is free. Downloading it    
  4337.                        will not affect the user's download         
  4338.                        statistics. Note that even though the file  
  4339.                        is free in this regard, the user must still 
  4340.                        have enough time remaining for the download.
  4341.  
  4342.                        RABETA.ZIP is both free and password        
  4343.                        protected with the password RACCESS. The    
  4344.                        user must supply the correct password before
  4345.                        being allowed to proceed with the download. 
  4346.                        Passwords are case insensitive and a maximum
  4347.                        of 15 characters in length. 
  4348.  
  4349.          LIMITS.CTL  :  This  file  allows  you  specify,  for each
  4350.                        security  level,  a daily time  limit,  file
  4351.                        download  limit  for  each  baud  rate,  and
  4352.                        optional  file ratios,  either in number  of
  4353.                        uploads to number of downloads,  or in total
  4354.                        kilobytes   uploaded   to  total   kilobytes
  4355.                        downloaded.  The  format of the file  is  as
  4356.                        follows:
  4357.  
  4358.        <Sec Lvl> <Time> <300> [1200] [2400] [4800] [9600]
  4359.          or:
  4360.        <Sec Lvl> <Time> <300> <1200> <2400> <4800> <9600> <R#> [RK]
  4361.  
  4362.                        Where  <Sec  Lvl>  is  the  security  level,
  4363.                        <Time>  is  the daily time limit,  <300>  to
  4364.                        <9600>   are  respective   download   limits
  4365.                        depending  on what baud rate the user  calls
  4366.                        at.   <R#>   is  the  ratio  of  uploads  to
  4367.                        downloads,  and [RK] is the ratio of uploads
  4368.                        in K to downloads in K.
  4369.  
  4370.                        If you only specify a download limit for say
  4371.                        300, 1200 and 2400 baud, the download limits
  4372.                        for  the  higher baud rates default  to  the
  4373.                        highest  baud rate specified,  in this  case
  4374.                        the limit set for 2400 baud.
  4375.  
  4376.                        If you specify a ratio by number (R#) value,
  4377.                        then the user will be required to upload one
  4378.                        file for every n they  download.  Similarly,
  4379.                        setting  the ratio by K will allow the  user
  4380.                        to  download only the specified kilobytes of
  4381.                        files per 1 kilobyte uploaded.
  4382.  
  4383.                        This is fairly complicated,  so look at this
  4384.                        example LIMITS.CTL:  
  4385.  
  4386.                            5  35  0
  4387.                            10 60  100 200 350 650 900 5 10
  4388.                            20 90  150 250 470 750 900 5
  4389.                            30 120 250 400 600 900 1200
  4390.                            50 300 900
  4391.  
  4392.  
  4393.                                     69
  4394.                        Security  level  5 entitles the user  to  35
  4395.                        minutes per day, but no downloads.
  4396.  
  4397.                        Security  level 10 entitles the user  to  60
  4398.                        minutes  per day,  100k of downloads at  300
  4399.                        baud,  200k at 1200 baud, 350k at 2400 baud,
  4400.                        650k at 4800 baud,  and 900k at 9600 baud or
  4401.                        faster. In addition, the user must upload at
  4402.                        least  one  file for every five  downloaded,
  4403.                        and may not download more than ten times the
  4404.                        total size of files uploaded.
  4405.  
  4406.                        Security  level 20 entitles the user  to  90
  4407.                        minutes  per day,  150k of downloads at  300
  4408.                        baud,  250k at 1200 baud, 470k at 2400 baud,
  4409.                        750k  at 4800 baud and 900k at 9600 baud  or
  4410.                        faster.  In  addition,  the  user  may  only
  4411.                        download  five  times  the number  of  files
  4412.                        he/she uploaded.
  4413.  
  4414.                        Security  level 30 entitles the user to  120
  4415.                        minutes  per day,  250k of downloads at  300
  4416.                        baud,  400k at 1200 baud, 600k at 2400 baud,
  4417.                        900k at 4800 baud and 1,200k at 9600 baud or
  4418.                        faster. There are no ratio restrictions.
  4419.  
  4420.                        Security  level 50 entitles the user to  300
  4421.                        minutes  per day,  and 900k of downloads  at
  4422.                        all speeds without any ratio restrictions.
  4423.  
  4424.          NAMES.RA      RemoteAccess allows you to assign           
  4425.                        "shortnames" to users you frequently send   
  4426.                        messages to. Set up this text file with the 
  4427.                        following format, one entry per line:
  4428.  
  4429.                        <shortname>,<realname>,<address>[,<subject>]
  4430.  
  4431.                        Eg:
  4432.                        rahq,Andrew Milner,3:690/625,RemoteAccess..
  4433.  
  4434.                        To use this feature, simply enter the       
  4435.                        shortname preceded by an asterisk when      
  4436.                        RemoteAccess asks you who the message is to.
  4437.                        In the above example, addressing a message  
  4438.                        to "*rahq" would fill in the to field with  
  4439.                        "Andrew Milner", and the subject field with 
  4440.                        "RemoteAccess..". If the message is netmail,
  4441.                        it would automatically be sent to 3:690/625.
  4442.  
  4443.          PHONENUM.CTL : Use this file to  specify phone  numbers or
  4444.                         segments  of phone  numbers that you know  
  4445.                         to be false. A PHONENUM.CTL that contains:
  4446.  
  4447.                            00-
  4448.                            000-
  4449.                            -0000
  4450.  
  4451.  
  4452.  
  4453.  
  4454.                                     70
  4455.                        Would  disallow  the numbers  "00-123-4567",
  4456.                        "000-123-4567",  "009-0000-1234".  The  rule
  4457.                        here  is that none of the specified  numbers
  4458.                        is  allowed to be imbedded anywhere  in  the
  4459.                        user's phone number.
  4460.  
  4461.          PWDTRASH.CTL : Allows you  to specify a list of  passwords
  4462.                        that  users  are not allowed  to  use.  This
  4463.                        could  contain  passwords  like  SECRET,  or
  4464.                        TEST.
  4465.  
  4466.          TRASHCAN.CTL : Allows you  specify  a list of  names  that
  4467.                        users may not use to log on to your  system.
  4468.                        In this file,  specify the undesirable names
  4469.                        one  per  line.  If for example you did  not
  4470.                        want  the names "Sysop",  "Jack  Daniels" or
  4471.                        "Superman"  used,  simply put the  following
  4472.                        lines in this file:
  4473.  
  4474.                            Sysop
  4475.                            Jack Daniels
  4476.                            Superman
  4477.  
  4478.                        The   tests  done  on  names  is  NOT  case-
  4479.                        sensitive, so the name "SYSOP" would also be
  4480.                        invalid. Names that contain any part of  the
  4481.                        names in the list are not allowed either.
  4482.  
  4483.  
  4484.  
  4485.  
  4486.  
  4487.  
  4488.  
  4489.  
  4490.  
  4491.  
  4492.  
  4493.  
  4494.  
  4495.  
  4496.  
  4497.  
  4498.  
  4499.  
  4500.  
  4501.  
  4502.  
  4503.  
  4504.  
  4505.  
  4506.  
  4507.  
  4508.  
  4509.  
  4510.  
  4511.  
  4512.  
  4513.  
  4514.  
  4515.                                     71
  4516.        THE USER DATABASE                    
  4517.        ────────────────────────────────────────────────────────────
  4518.  
  4519.        The  user file is possibly the most important single file on
  4520.        your BBS.  It contains all the information about each user's
  4521.        history, screen settings, and vital security data. Switch to
  4522.        your   system   directory   and  fire  up  USERED.EXE.  This
  4523.        utility  allows  you  to add,  modify or delete  any  user's
  4524.        record.  If  there are already some users in the  user-file,
  4525.        you will be presented with a list showing each user's  name,
  4526.        location and security level.  Select a user either by typing
  4527.        in the name, or moving the highlight bar to the entry on the
  4528.        screen and pressing RETURN.
  4529.  
  4530.        After  the  user is selected you will be presented with  the
  4531.        Edit Screen.  This lists the entire user's record which  can
  4532.        be modified and saved if you wish. 
  4533.  
  4534.        If  there  are no users already in the user-file,  the  Edit
  4535.        Screen will appear immediately for you to enter the  details
  4536.        of  the  first user.  Note that the only required  piece  of
  4537.        information (or "field") is the name,  and you can't proceed
  4538.        any further until you enter one.  You'll want to be included
  4539.        in  the  user file,  so enter your own name in  this  field.
  4540.  
  4541.        Next,  go  through  each of the other fields and  enter  the
  4542.        correct  details.  When finished,  press [CONTROL-ENTER]  to
  4543.        save  the information and then ESCAPE to exit.  If you don't
  4544.        want to save, just press ESCAPE by itself.
  4545.  
  4546.        To add a new user, simply press the INS key on the user list
  4547.        screen  and a blank record will be created for you to  edit.
  4548.  
  4549.        Deleting a user is accomplished by  moving the highlight bar
  4550.        to the user you want to delete and pressing the DEL  key.  A
  4551.        marker  will appear in the right hand column to signify that
  4552.        the  user is marked for deletion.  Note that the user  isn't
  4553.        actually  removed from the user file at  this  stage.  Users
  4554.        that have been marked for deletion are  removed  by  packing
  4555.        the user-file,  which should be  done  regularly  using  the
  4556.        utility RAUSER.
  4557.  
  4558.  
  4559.  
  4560.  
  4561.  
  4562.  
  4563.  
  4564.  
  4565.  
  4566.  
  4567.  
  4568.  
  4569.  
  4570.  
  4571.  
  4572.  
  4573.  
  4574.  
  4575.  
  4576.                                     72
  4577.        Information stored in the user database
  4578.        ────────────────────────────────────────────────────────────
  4579.  
  4580.        This  section  details all  the information  contained about
  4581.        each user in the user database:
  4582.  
  4583.  
  4584.        Name               : User's full name
  4585.        Handle             : User's registered handle
  4586.        Location           : Where the user is calling from
  4587.        Password           : Secret password
  4588.        Security level     : Security level (1-64000, 0 to lock out)
  4589.        Home telephone     : Home/voice telephone number
  4590.        Business telephone : Business/data telephone number
  4591.        A flags            : "A" flag settings ("-" or "X")
  4592.        B flags            : "B" flag settings ("-" or "X")
  4593.        C flags            : "C" flag settings ("-" or "X")
  4594.        D flags            : "D" flag settings ("-" or "X")
  4595.        Netmail credit     : Netmail credit remaining
  4596.        Unsent netmail     : Value of unsent (unexported) netmail
  4597.        Uploads            : Total number of uploads
  4598.        Downloads          : Total number of downloads
  4599.        Upload K           : Total kilobytes of uploads
  4600.        Download K         : Total kilobytes of downloads
  4601.        Today download K   : Kilobytes downloaded today
  4602.        Comment            : Comment, can contain anything
  4603.        Last call (time)   : Time user last called
  4604.        Last call (date)   : Date user last called
  4605.        Subscription       : Subscription expiry date
  4606.        Birthdate          : Date of birth
  4607.        Time used          : Minutes used today
  4608.        Screen length      : User's screen length
  4609.        Password calls     : Number of calls since last pwd change
  4610.        Msgs posted        : Total number of messages posted
  4611.        High msg           : Highest message read
  4612.        Deleted            : Delete user when database is packed?
  4613.        Screen clear       : Send screen clear codes?
  4614.        Screen pause       : Pause at the end of each screen?
  4615.        ANSI               : Send ANSI codes?
  4616.        AVATAR             : Send AVATAR codes?
  4617.        Locked             : Never kill user?
  4618.        Xfer priority      : Ignore download hours and ratios?
  4619.        Full screen editor : Use the full screen ANSI msg editor?
  4620.        Quiet mode         : Ignore online messages?
  4621.        Hotkeys            : Use hotkeys?
  4622.        Full screen viewer : Use the full screen msg viewer?
  4623.        Hidden             : Hidden from the user list?
  4624.        Group number       : User's group number (1 - 255)
  4625.  
  4626.  
  4627.  
  4628.  
  4629.  
  4630.  
  4631.  
  4632.  
  4633.  
  4634.  
  4635.  
  4636.  
  4637.                                     73
  4638.        Packing and sorting the user file               
  4639.        ────────────────────────────────────────────────────────────
  4640.  
  4641.        RAUSER.EXE is the utility that is used to maintain the user-
  4642.        file.  Not only will it remove users marked for deletion, it
  4643.        can  also delete users that have not called your BBS  for  a
  4644.        certain number of days as well as sort the users in order of
  4645.        security  level  and surname.  RAUSER may be  run  from  any
  4646.        directory,  will automatically locate system and user files,
  4647.        and will insert an activity summary in your system log.  The
  4648.        following command-line parameters are valid:
  4649.  
  4650.  
  4651.             -P       Pack the user-file, removing users marked  for
  4652.                      deletion.
  4653.  
  4654.             -S       Sort users in  order  of  security  level  and
  4655.                      surname.
  4656.  
  4657.             -D[n]    Delete users who have not called for [n] days.
  4658.                      Note that this parameter implies a pack       
  4659.                      operation.
  4660.  
  4661.             -V       Verbose logging; list any users that were     
  4662.                      deleted during a pack operation.
  4663.  
  4664.             -M[s]    Specify the maximum security level user to be 
  4665.                      affected by a pack or delete operation. Put   
  4666.                      another way : "exempt all users with security 
  4667.                      level [s] and above from being deleted" .
  4668.  
  4669.  
  4670.  
  4671.  
  4672.  
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.  
  4683.  
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.  
  4691.  
  4692.  
  4693.  
  4694.  
  4695.  
  4696.  
  4697.  
  4698.                                     74
  4699.        THE MESSAGE DATABASE
  4700.        ────────────────────────────────────────────────────────────
  4701.  
  4702.        RAMSG is the RemoteAccess message  base maintenance utility.
  4703.        It's primary function is  to trim the number of  messages in
  4704.        local   and echomail conferences  and maintain them   at   a
  4705.        manageable   level. RACONFIG provides the  ability to enter,
  4706.        add  and  maintain     message  areas  -  RAMSG  uses   this
  4707.        information (contained in MESSAGES.RA)  to delete old and/or
  4708.        excess  messages.   RAMSG will   also   attempt   to  repair
  4709.        damaged  message bases; it has a  number of integrity checks
  4710.        built  in so that  if it detects  that the message  base  is
  4711.        damaged in  any way,  it will automatically  re-create index
  4712.        files  (even   if  they are  missing)  and warn  of possible
  4713.        problems.
  4714.  
  4715.        All of  RAMSG's activities are logged in  the  system  log. 
  4716.        Some options are provided for statistical information.
  4717.  
  4718.        Note that a value of 0 in any of  the fields on the  message
  4719.        area entry  screen in  RACONFIG will cause  RAMSG to  ignore
  4720.        that  option. For example, if the maximum number of messages
  4721.        is set  to 0, RAMSG will not  kill messages based on number.
  4722.        Prior running RAMSG, you should  ensure that all areas  have
  4723.        been set up correctly.
  4724.  
  4725.        RAMSG invoked  without a command line  results  in   a  help
  4726.        screen being displayed.
  4727.  
  4728.        When  one or more of the arguments below is specified, RAMSG
  4729.        searches  for CONFIG.RA  (first the current  directory, then
  4730.        via the  RA  environment  variable),  MESSAGES.RA  (in  the 
  4731.        current directory,  then the system directory)  and then the
  4732.        message base files.   Failure to  find one or more  of these
  4733.        files will result in  RAMSG aborting. If CONFIG.RA is  found
  4734.        and the system  log file can be  opened, RAMSG will  log any
  4735.        errors there.
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742.        Message database size limitations
  4743.        ────────────────────────────────────────────────────────────
  4744.  
  4745.        Due  to the  message  database file  structures, there  is a
  4746.        maximum  physical limit  on the  number  of messages  it can
  4747.        contain.  The maximum  number of  messages the  database can
  4748.        hold is approximately 16,000.  You should configure RAMSG so
  4749.        that this limit is never exceeded.
  4750.  
  4751.        There  is  also a  limitation on  the  value of  the highest
  4752.        numbered message, which may never  exceed 32,767. It is good
  4753.        practice  to regularly  (preferably  nightly)  renumber  the
  4754.        message  database  to  ensure   that  this  limit  is  never
  4755.        breached.
  4756.  
  4757.  
  4758.  
  4759.                                     75
  4760.        RAMSG Command summary
  4761.        ---------------------
  4762.  
  4763.         -I Re-create index files & check
  4764.            C=Kill crosslinked messages
  4765.            U=Kill unknown boards
  4766.            R=Renumber
  4767.  
  4768.         -P Pack (compress) message base
  4769.            K=Purge 
  4770.            R=Renumber
  4771.            O=Overwrite
  4772.            A=Overwrite if necessary 
  4773.  
  4774.         -K Purge messages from info in MESSAGES.RA
  4775.  
  4776.         -L Link reply chains
  4777.  
  4778.         -R Renumber messages
  4779.  
  4780.         -S Display/log message base statistics
  4781.            All options:  S=Statistics  V=Verbose stats
  4782.  
  4783.  
  4784.  
  4785.  
  4786.        RAMSG functions (NOT case sensitive)
  4787.        ------------------------------------
  4788.  
  4789.                -I      INDEX [Options : C, R, U]
  4790.  
  4791.                        This  option  rebuilds  the  message  base  
  4792.                        index files, MSGIDX.BBS, MSGTOIDX.BBS and   
  4793.                        MSGINFO.BBS. It also  checks the integrity  
  4794.                        of all message base files and rebuilds other
  4795.                        information as necessary. Errors in the     
  4796.                        message base are logged.
  4797.  
  4798.                        During the  index  rebuild,  you  may       
  4799.                        choose to delete  messages  from  unknown   
  4800.                        message areas (those areas which have no    
  4801.                        entry in the name field)  and  messages with
  4802.                        message board numbers outside the valid     
  4803.                        range of 1-200.
  4804.  
  4805.                        Under  some  circumstances  RAMSG  may      
  4806.                        detect  a "sequence error" (when numbers are
  4807.                        out of order). Since  this  causes          
  4808.                        significant problems with software using the
  4809.                        message base, RAMSG  considers this serious,
  4810.                        and therefore will not  proceed with  any   
  4811.                        operation  other  than  an  index  rebuild  
  4812.                        until this is corrected using the "R"       
  4813.                        option, to force message base renumbering.
  4814.  
  4815.  
  4816.  
  4817.  
  4818.  
  4819.  
  4820.                                     76
  4821.                        "Crosslinking" of message text is also      
  4822.                        considered a serious problem, and this  will
  4823.                        prevent  RAMSG  repacking the message base. 
  4824.                        Cross-linking occurs when more than one     
  4825.                        message  references  the  same section of   
  4826.                        text in MSGTXT.BBS.
  4827.  
  4828.                        Following are some examples  of  what  an   
  4829.                        index rebuild command might look like:
  4830.  
  4831.                        RAMSG -Icu
  4832.  
  4833.                        Rebuild indices, kill messages in  unknown  
  4834.                        areas and crosslinked messages.
  4835.  
  4836.                        RAMSG -I
  4837.  
  4838.                        Rebuild index files only.
  4839.  
  4840.  
  4841.                -P      PACK  [options : K, R, O, A]
  4842.                
  4843.                        Packs  the  message  base,  by  eliminating 
  4844.                        all deleted  messages  and  message  text.  
  4845.                        Deleting (the -K option, for example)       
  4846.                        messages does not remove them from the      
  4847.                        message base files, it simply marks them for
  4848.                        deletion. You  MUST  pack the message base  
  4849.                        to reclaim the space occupied by these      
  4850.                        deleted messages.
  4851.  
  4852.                        PACK also provides options  to  purge       
  4853.                        old/excess messages (same as -K, except     
  4854.                        that  -K  does  not  pack) and renumber     
  4855.                        (same as -R), so all  standard              
  4856.                        maintenance functions can be carried out  in
  4857.                        the one command.
  4858.                        
  4859.                        RAMSG normally packs the message base by    
  4860.                        copying messages from the existing          
  4861.                        message base into temporary files,          
  4862.                        deleting the original files, then           
  4863.                        renaming the temporary files to their       
  4864.                        correct names.  This is the safest option to
  4865.                        use, since it is possible to rebuild the    
  4866.                        message base if for any reason the PACK     
  4867.                        process is interrupted (for example, by     
  4868.                        power failure). However, this requires that 
  4869.                        at least as much space as occupied by the   
  4870.                        old message base files be free on your hard 
  4871.                        disk.                            
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.  
  4880.  
  4881.                                     77
  4882.                        To get around this, RAMSG provides an       
  4883.                        option to pack the message base "on top" of 
  4884.                        the existing one without using temporary    
  4885.                        files.  This directly overwrites the        
  4886.                        existing files; and the problem with this is
  4887.                        that if the process is  interrupted, the    
  4888.                        message base may be irreparably  damaged    
  4889.                        and data could be lost.  To use overwrite   
  4890.                        mode, RAMSG requires the 'o' option in the  
  4891.                        PACK command; this forces overwriting       
  4892.                        unconditionally. To ensure that the message 
  4893.                        base is processed, while  taking advantage  
  4894.                        of  a  safer  environment,  RAMSG  also     
  4895.                        provides an 'a' option, which will use      
  4896.                        overwrite mode only if there is insufficient
  4897.                        space for a regular pack.
  4898.  
  4899.                        Examples:
  4900.  
  4901.                        RAMSG -Pkra
  4902.  
  4903.                        Pack the message base, kill messages        
  4904.                        according to information in MESSAGES.RA,    
  4905.                        renumber messages and use overwrite  mode   
  4906.                        only if insufficient disk space for a       
  4907.                        regular pack.
  4908.  
  4909.                        RAMSG -Po
  4910.  
  4911.                        Pack the message base, using overwrite mode.
  4912.  
  4913.  
  4914.                -K      Purge messages
  4915.  
  4916.                        This option  purges  messages  according  to
  4917.                        the maximum number of messages and aging    
  4918.                        information specified for each area in      
  4919.                        MESSAGES.RA. Note that the messages are not 
  4920.                        actually removed, they are simply marked for
  4921.                        deletion. Use the pack command to reclaim   
  4922.                        the space that these messages occupy.
  4923.  
  4924.  
  4925.                -L      Link reply chains
  4926.  
  4927.                        Links  reply  chains  in  each  area   (this
  4928.                        is automatically done by other maintenance  
  4929.                        functions where necessary). You would use   
  4930.                        this option by itself after an import by    
  4931.                        your echomail processor, for example.
  4932.  
  4933.  
  4934.                -R      Renumber messages
  4935.  
  4936.                        Renumbers the message base.  This option may
  4937.                        also be used to cure "out of sequence"      
  4938.                        errors.
  4939.  
  4940.  
  4941.  
  4942.                                     78
  4943.                -S      Display/log message base statistics
  4944.  
  4945.                        Simply logs message base and disk statistics
  4946.                        for your own information. A 'v' after this  
  4947.                        option displays verbose statistics for each 
  4948.                        message area.
  4949.  
  4950.  
  4951.        You may  run several  operations on  the same  command line,
  4952.        but since there is  some overlap in functionality,  the need
  4953.        to do  this is rare.   One instance of where  you might need
  4954.        this  facility  is  to force the message base to  be "clean"
  4955.        prior running a pack; for example:
  4956.  
  4957.                RAMSG -Icur -Pkra
  4958.  
  4959.        Checks/rebuilds index files, deleting messages in unknown   
  4960.        areas, fixes cross-linked messages and forces a  renumber   
  4961.        to fix sequence errors.  It then will proceed to pack and   
  4962.        renumber the message base  after  killing  excess/expired   
  4963.        messages using overwrite mode if required.
  4964.  
  4965.  
  4966.        Several errorlevel  exits are provided to  allow  management
  4967.        by batch file:
  4968.  
  4969.                1       No arguments specified; help message given. 
  4970.                2       Cannot access/locate CONFIG.RA
  4971.                3       Out of or insufficient memory
  4972.                4       Error opening/locating a file
  4973.                5       Serious IO error
  4974.  
  4975.  
  4976.  
  4977.  
  4978.  
  4979.  
  4980.  
  4981.  
  4982.  
  4983.  
  4984.  
  4985.  
  4986.  
  4987.  
  4988.  
  4989.  
  4990.  
  4991.  
  4992.  
  4993.  
  4994.  
  4995.  
  4996.  
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.  
  5003.                                     79
  5004.        MAIL NETWORKING 
  5005.        ────────────────────────────────────────────────────────────
  5006.                     
  5007.        What  is a mail network?  Basically it is a set of  bulletin
  5008.        board  systems  that are capable of exchanging messages  and
  5009.        files   with   each  other  without  the  need   for   human
  5010.        intervention.  All  the discussion which follows relates  to
  5011.        FidoNet,  the world's largest amateur mail network.  FidoNet
  5012.        consists of approximately 5,000 bulletin board systems, each
  5013.        of  which is assigned a unique "address".  A file  called  a
  5014.        nodelist   stores  all  these  addresses  along  with  other
  5015.        information  about  each  system.   Think  of  it  like   an
  5016.        international "telephone book".
  5017.  
  5018.        Being  part of a network has two basic attractions;  NetMail
  5019.        and EchoMail.  NetMail allows you to send a private  message
  5020.        to  any  user  of  any one of the bulletins  boards  in  the
  5021.        network at little or no cost to you. EchoMail is a method of
  5022.        creating  a huge message area that many hundreds of  systems
  5023.        can potentially participate in.  Usually all EchoMail  areas
  5024.        will  contain only public messages,  and are organised  into
  5025.        either  general  discussion areas,  or areas that deal  with
  5026.        specific issues and or topics.
  5027.  
  5028.        The net is organised into several levels,  which are usually
  5029.        based on geographical proximity.  At the highest level there
  5030.        are five "zones";  zone 1 is the USA, zone 2 is Europe, zone
  5031.        3  is the Pacific Rim,   zone 4 is  South America, zone 5 is
  5032.        Africa and zone 6 is Asia.  Within each zone are a number of
  5033.        "regions"  that span  large geographical  areas.   Typically
  5034.        there will be between 5 and 18 regions per zone. Each region
  5035.        is further divided into "nets".   Each  net  has  a   unique
  5036.        net   number,   and   the distribution of these nets is also
  5037.        based  on  geographical   and  technical     considerations.
  5038.        Finally,  within   the net are  a number   of nodes.  A node
  5039.        refers to a single bulletin  board system. 
  5040.  
  5041.        To find out about obtaining a node number,  or an "address",
  5042.        contact  the nearest FidoNet bulletin board.  The sysop will
  5043.        usually be more than happy to help you out.
  5044.  
  5045.        Before  going  any  further,  let's  talk  about  the  extra
  5046.        software you will need to set up as a node. Firstly you will
  5047.        need  an  echomail  processor.  This is  the  program  which
  5048.        unpacks the mail you will receive,  and imports it into your
  5049.        RemoteAccess  message-base,  as well as packing up  outbound
  5050.        mail  that  needs  to be sent  out.  RemoteAccess  does  NOT
  5051.        include  such  a beast.  There are several other  processors
  5052.        around that will do the job:
  5053.  
  5054.             Echogen and QEcho, both by Adam Hudson,
  5055.             ZMailH, by Claude N. Warren,
  5056.             TosScan, by Joaquim Homrighausen,
  5057.             IMAIL, by Fabiano Fabris.
  5058.  
  5059.  
  5060.  
  5061.  
  5062.  
  5063.  
  5064.                                     80
  5065.        The  other  piece  of  software you'll  need  is  a  mailer.
  5066.        RemoteAccess  will  not  directly  communicate  with   other
  5067.        network  bulletin  boards,  so a separate program fills  the
  5068.        gap. The  two most  widely used  different types of  mailers
  5069.        are:
  5070.  
  5071.             FrontDoor, by Joaquim Homrighausen,
  5072.             BinkleyTerm, by Bit Bucket Software.
  5073.  
  5074.        Both of these products  are available on a  shareware basis,
  5075.        and  like  the  echomail processors,    will    usually   be
  5076.        available   on  most  FidoNet bulletin boards if you ask the
  5077.        sysop nicely enough.
  5078.  
  5079.        The  node  number  you are assigned will be  of  the  format
  5080.        Zone:Net/Node.Point.  This initial node number should be put
  5081.        into  your  configuration file using the ADDRESS  option  of
  5082.        RACONFIG. Don't worry about the AKA addresses at this stage.
  5083.  
  5084.        The next step is to set up your EchoMail message areas.  You
  5085.        will  usually be given a list of areas that are available to
  5086.        you.  Each  area is identified by an uppercase  alphanumeric
  5087.        name. As far as RemoteAccess is concerned, all you need is a
  5088.        description  of each area you plan to "plug into".  Fire  up
  5089.        RACONFIG,  and  go to the MESSAGE AREAS  window.  Select  an
  5090.        unused  message area,  and enter the area's name in the NAME
  5091.        field.  Next,  set the TYPE OF MAIL field to  ECHOMAIL,  and
  5092.        MESSAGE  STATUS to PUBLIC.  Most EchoMail areas don't  allow
  5093.        the  use of aliases,  so set the area  to "real names only".
  5094.        The AKA   ADDRESS line shows  your assigned node number.  If
  5095.        it   doesn't,   hit  RETURN on  this option  and  select the
  5096.        correct address.
  5097.  
  5098.        Each  EchoMail message  that is posted on your system  could
  5099.        potentially be read by hundred of other sysops and users, so
  5100.        you can put a "one-liner" at the end of each message. In the
  5101.        ORIGIN LINE field enter a short message. This should contain
  5102.        at least the name of your system,  and possibly where it  is
  5103.        or the phone-number, so that other users know where to call.
  5104.        Your node number is also appended to the end of the message,
  5105.        so a typical origin line might read:
  5106.  
  5107.             * Origin : RemoteAccess HQ (3:690/625.0)
  5108.  
  5109.        Don't  put  the "* Origin" part in - this is added  by  the 
  5110.        software).  If  you  don't  specify an  origin  line  for  a
  5111.        particular  area,  RemoteAccess will use the DEFAULT  ORIGIN
  5112.        LINE.
  5113.  
  5114.        If running  a multi-node  system, the  line number  that the
  5115.        message was posted on may be inserted in the origin line  by
  5116.        using the '@' macro character in any origin line definition.
  5117.  
  5118.  
  5119.  
  5120.  
  5121.  
  5122.  
  5123.  
  5124.  
  5125.                                     81
  5126.        The  next  step  is to configure RemoteAccess  for  NetMail.
  5127.        Select another unused message area,  and call it  "NetMail",
  5128.        or something similar. Next, set the TYPE OF MAIL to NETMAIL,
  5129.        and  MESSAGE STATUS to PRIVATE.  NetMail messages don't have
  5130.        origin lines appended to them so leave the origin line entry
  5131.        blank.  RemoteAccess  incorporates  a  comprehensive  online
  5132.        nodelist browsing facility, which allows users to search for
  5133.        nodes  in particular zones,  regions or  nets.  The  section
  5134.        INSTALLING  NODELIST  FILES  explains  how  to  enable  this
  5135.        feature.
  5136.  
  5137.        That's it!  RemoteAccess is now fully configured for network
  5138.        mail.  Assuming that you have a suitable mailer and echomail
  5139.        processor,  all that is required is to set them up correctly
  5140.        and you're in business.  An explanation of setting these  up
  5141.        is beyond the scope of this document,  full instructions are
  5142.        available with each respective package.
  5143.  
  5144.  
  5145.  
  5146.  
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.  
  5156.  
  5157.  
  5158.  
  5159.  
  5160.  
  5161.  
  5162.  
  5163.  
  5164.  
  5165.  
  5166.  
  5167.  
  5168.  
  5169.  
  5170.  
  5171.  
  5172.  
  5173.  
  5174.  
  5175.  
  5176.  
  5177.  
  5178.  
  5179.  
  5180.  
  5181.  
  5182.  
  5183.  
  5184.  
  5185.  
  5186.                                     82
  5187.        Installing the nodelist files 
  5188.        ────────────────────────────────────────────────────────────
  5189.  
  5190.        Most  other BBS software requires you to maintain large  and
  5191.        unwieldy   custom  nodelist  files  for  NetMail  operation.
  5192.        RemoteAccess  uses the "raw" (St.  Louis) nodelist that  you
  5193.        already  have for your front-end mailer,  in addition  to  a
  5194.        small  (around 5K) index file.  The key to the system is the
  5195.        nodelist index compiler (RANODE.EXE). You should adjust your
  5196.        batch files so it is run every time any changes are made  to
  5197.        your  raw nodelist (when you receive a NODEDIFF update,  for
  5198.        example).  RANODE can be run from any directory, and locates
  5199.        your raw nodelist via the NODELIST PATH defined in RACONFIG.
  5200.  
  5201.        It  scans the most recent nodelist present and produces  the
  5202.        index     files    (NODEIDX.RA  and NODEINC.RA)  in    your 
  5203.        RemoteAccess     system directory.   If   you  have multiple
  5204.        nodelists  to process,    simply specify  the  names of  any
  5205.        additional  nodelists  on  the command-line  when  RANODE is
  5206.        executed.  
  5207.  
  5208.        Example  :  Compiling  a  FidoNet  nodelist  only.  The  raw
  5209.        nodelist  is in the C:\NODELIST directory.  Simply set  your
  5210.        NODELIST  PATH  in RACONFIG to C:\NODELIST,  and run  RANODE
  5211.        whenever you process  a nodediff,  without any  command-line
  5212.        parameters.
  5213.  
  5214.        Example : Compiling a FidoNet and ParaNet combined nodelist.
  5215.        The  FidoNet  NODELIST.nnn  and  ParaNet  PARALIST.PVT   raw
  5216.        nodelist  files  are in C:\NODELIST. Simply run  RANODE with
  5217.        the following parameter:
  5218.  
  5219.             RANODE PARALIST.PVT
  5220.  
  5221.        Up  to ten  nodelists  (including the  FidoNet  one) may  be
  5222.        specified -  wildcards and pattern  matching characters  are
  5223.        valid.
  5224.  
  5225.        Note that  it  is  not  necessary  to  specify  the  FidoNet
  5226.        NODELIST.nnn  as well,  as RANODE  includes the  most recent
  5227.        FidoNet nodelist automatically.
  5228.  
  5229.  
  5230.        In  order to control the volume of netmail your users  send,
  5231.        each user has a "netmail credit" field in his or her record.
  5232.        RemoteAccess   will  give  all  new  users  a  credit  limit
  5233.        based  on  the NEW USER NETMAIL CREDIT setting in  RACONFIG.
  5234.  
  5235.        You  define  the  cost  of sending a  single  message  to  a
  5236.        particular node in a control file called NODECOST.CTL  which
  5237.        is located in the RemoteAccess system directory. Each time a
  5238.        user sends a netmail message, it's cost is deducted from his
  5239.        or her account.
  5240.  
  5241.        The cost structure for your entire nodelist is set up by one
  5242.        or more entries of five keywords:
  5243.  
  5244.  
  5245.  
  5246.  
  5247.                                     83
  5248.        DEFAULT <cost>
  5249.  
  5250.        Assigns <cost> to any nodes that are not assigned a specific
  5251.        cost later on in the control file.
  5252.  
  5253.  
  5254.  
  5255.        ZONE <zone> <cost>
  5256.  
  5257.        Assigns  <cost> to all nodes in <zone>.  This overrides  the
  5258.        DEFAULT keyword.
  5259.  
  5260.  
  5261.  
  5262.        REGION <region> <cost>
  5263.  
  5264.        Assigns <cost> to all nodes in <region>.  This overrides the
  5265.        DEFAULT and ZONE keywords.
  5266.  
  5267.  
  5268.  
  5269.        NET <net> <cost>
  5270.  
  5271.        Assigns  <cost>  to all nodes in <net>.  This overrides  the
  5272.        DEFAULT, ZONE and REGION keywords.
  5273.  
  5274.  
  5275.  
  5276.        NODE <node> <cost>
  5277.  
  5278.        Assigns  <cost> to <node>. <Node>  is a fully qualified node
  5279.        address. This overrides all other keywords.
  5280.  
  5281.  
  5282.        Sample NODECOST.CTL:
  5283.  
  5284.        DEFAULT       200 ; A message to anywhere costs 200 cents,
  5285.        ZONE      3    60 ; except in zone 3, which costs 60 cents.
  5286.        ZONE      2   260 ; Messages to zone 2 cost a bit more,   
  5287.        REGION   55    30 ; Within our region only costs 30 cents.
  5288.        NET     690     0 ; Msgs within our net are free,
  5289.        NODE    690/999 5 ; except this node which isn't local.
  5290.  
  5291.  
  5292.        The  control  file may contain a maximum of 150  entries  of
  5293.        each  keyword,  and  duplicate  entries  are  obviously  not
  5294.        permitted.
  5295.  
  5296.  
  5297.  
  5298.  
  5299.  
  5300.  
  5301.  
  5302.  
  5303.  
  5304.  
  5305.  
  5306.  
  5307.  
  5308.                                     84
  5309.        MULTI - NODE OPERATION
  5310.        ────────────────────────────────────────────────────────────
  5311.  
  5312.        It  is  assumed  that  you have some  knowledge  of  running
  5313.        RemoteAccess already, or have at least run a single line BBS
  5314.        for some time.  If you haven't,  it is strongly  recommended
  5315.        that   you run one line  for a little while  to  familiarise
  5316.        yourself with the terminology and operation of RemoteAccess.
  5317.  
  5318.        The  idea of multi-node operation is that more than one user
  5319.        can be on-line at the same time to the same BBS.  To do this
  5320.        safely,  it  is  necessary for RemoteAccess  to  manage  the
  5321.        configuration   and  data  files  it  uses  very  carefully.
  5322.  
  5323.        Firstly,  tell RemoteAccess that it's running in  multi-node
  5324.        mode  by setting the MULTI LINE option to "Yes" in RACONFIG.
  5325.        You  should  also set CHECK FOR MULTI LOGON  to  "Yes".  Not
  5326.        doing this can cause unpredictable  results when a user logs
  5327.        on to more than one line at once.
  5328.  
  5329.        Set the  SYSTEM LOG NAME to  "RA.LOG". Make sure you  do NOT
  5330.        specify a full path with the name.
  5331.  
  5332.        Next create one child directory of your system directory for
  5333.        each line you intend to operate. For example, assuming  that
  5334.        the  system  directory  is   C:\RA,  for  two  lines  create
  5335.        C:\RA\LINE1 and C:\RA\LINE2 (the actual directory  names are
  5336.        not important).
  5337.  
  5338.        At  this  stage, ensure  that  the  RA environment  variable
  5339.        points to the system  directory so each line will be able to
  5340.        locate the configuration files.
  5341.  
  5342.        Why  separate directories? Many  on-line utilities and doors
  5343.        are not  multi-node aware,  so they  must  be isolated  from
  5344.        themselves in the  event that more than one copy of the same
  5345.        door is executed at the same  time. Thus it may be necessary
  5346.        to place  extra configuration files  for some doors  in each
  5347.        line directory. 
  5348.  
  5349.        For example, to install QuickEd in a multi-node environment,
  5350.        ensure that QUICKED.EXE is in the system directory (C:\RA in
  5351.        this  example)  and  that  the EXTERNAL  EDITOR  setting  in
  5352.        RACONFIG  is set  to  "C:\RA\QUICKED.EXE".  To complete  the
  5353.        installation, copy  the  files QUICKED.HLP  and  QUICKED.CFG
  5354.        into  each  line  directory; these  two  files  need not  be
  5355.        present in the system directory.
  5356.  
  5357.        All that is necessary now is to  create the batch files that
  5358.        call each copy of RA for each line:
  5359.  
  5360.        REM Sample batch file to fire up line 1
  5361.        :START
  5362.          CD \RA\LINE1
  5363.          RA -N1
  5364.          REM Check errorlevels etc
  5365.          GOTO START
  5366.  
  5367.  
  5368.  
  5369.                                     85
  5370.        Note  that   the  -N1   parameter  is  not   required  since
  5371.        RemoteAccess defaults  to line 1;  it is  included only  for
  5372.        completeness.
  5373.  
  5374.        REM Sample batch file to fire up line 2, using FrontDoor 
  5375.        REM as a front-end mailer in shell to mailer mode
  5376.        :START
  5377.          CD \RA\LINE2
  5378.          RA -M\FD\FD.EXE*M -N2
  5379.          REM Check errorlevels etc
  5380.          GOTO START
  5381.  
  5382.        RemoteAccess will  keep a  separate system log  (RA.LOG) and
  5383.        usage graph file (TIMELOG.BBS) in each line directory.
  5384.  
  5385.        The  placement  of the EXITINFO.BBS  and  DORINFO1.DEF  door
  5386.        files is handled differently in a multi-node environment. In
  5387.        a  single  line installation these files are written to  the
  5388.        RemoteAccess system directory.  In multi-node mode they  are
  5389.        written  to the current  (default) directory,  thus ensuring
  5390.        that each door has it's  own set of info files from  the BBS
  5391.        at all times.
  5392.  
  5393.        Additional  configuration  flexibility  is  provided  in the
  5394.        method RemoteAccess uses to locate  the configuration (*.RA)
  5395.        files. If one or more of the *.RA config files is present in
  5396.        a particular  line directory, then the  information in those
  5397.        files  will  override  the   information  contained  in  the
  5398.        corresponding config file in the system directory.
  5399.  
  5400.        For  example, it  may  be necessary  for  each line  to  use
  5401.        different  modem  configuration  information. This  data  is
  5402.        contained in CONFIG.RA, so make a copy of  this file in each
  5403.        line  directory.  Change to  the  line 1  directory  and use
  5404.        RACONFIG to edit the  modem settings. Save your changes  and
  5405.        repeat the procedure for line 2. When RemoteAccess fires up,
  5406.        it  will use the CONFIG.RA in the current directory that you
  5407.        just edited,  and  the  other  config files  in  the  system
  5408.        directory.
  5409.  
  5410.        The  LIMITS.CTL file works in the same way; you may override
  5411.        the global settings in the system directory by making a copy
  5412.        of LIMITS.CTL in  one or more  line directories and  editing
  5413.        with an ASCII text editor. This enables each line to exhibit
  5414.        different  download  and  time  limits  for  one  particular
  5415.        security level.
  5416.  
  5417.        Beware  of  third party utilities that write to  the  system
  5418.        files!  RemoteAccess  is specifically written so  that  many
  5419.        users  can read and post messages simultaneously to the same
  5420.        message-base,  but other programs probably AREN'T. Check the
  5421.        documentation  very  carefully  before  you  fire  up   your
  5422.        favourite  off-line  mail editor and start posting  messages
  5423.        while someone else is on-line.  Similarly,  if your echomail
  5424.        processor  does  not  lock  the  message-base  files   while
  5425.        working,  you  should set up your system to ensure that mail
  5426.        is  never imported when there is a user  on-line.  Exporting
  5427.        messages however, IS permitted.
  5428.  
  5429.  
  5430.                                     86
  5431.        It's  quite  likely that you'll need to increase  the  FILES
  5432.        setting  in  your  CONFIG.SYS  if  RemoteAccess  is  running
  5433.        several  lines  under  a multitasker.  You'll  also  need  a
  5434.        separate  batch-file  for each line to  invoke  RemoteAccess
  5435.        with the correct command-line parameters.  See the reference
  5436.        section on command-line parameters for information on the -N
  5437.        parameter.
  5438.  
  5439.        It  is  ESSENTIAL that  you  load  SHARE.EXE when  operating
  5440.        multi-node. SHARE is  a utility  that comes  with DOS  which
  5441.        RemoteAccess uses  to lock the  database files  it uses,  to
  5442.        ensure  that no conflicts  occur. Not using  SHARE is asking
  5443.        for trouble; you  risk severe corruption  of both your  user
  5444.        and message database files.
  5445.  
  5446.  
  5447.  
  5448.  
  5449.  
  5450.  
  5451.  
  5452.  
  5453.  
  5454.  
  5455.  
  5456.  
  5457.  
  5458.  
  5459.  
  5460.  
  5461.  
  5462.  
  5463.  
  5464.  
  5465.  
  5466.  
  5467.  
  5468.  
  5469.  
  5470.  
  5471.  
  5472.  
  5473.  
  5474.  
  5475.  
  5476.  
  5477.  
  5478.  
  5479.  
  5480.  
  5481.  
  5482.  
  5483.  
  5484.  
  5485.  
  5486.  
  5487.  
  5488.  
  5489.  
  5490.  
  5491.                                     87
  5492.        REFERENCE SECTION            
  5493.        ────────────────────────────────────────────────────────────
  5494.  
  5495.  
  5496.  
  5497.        Sysop keys                     
  5498.        ────────────────────────────────────────────────────────────
  5499.  
  5500.        The following keys work while a user is on-line:
  5501.  
  5502.  
  5503.        [F1] [F2]    : Comprehensive user statistics on an optional 
  5504.        [F3] [F5]      two-line  status  bar at the bottom  of  the 
  5505.                       screen.
  5506.  
  5507.        [F4]         : System statistics. This is the default status
  5508.                       bar  that is displayed when  RemoteAccess  is
  5509.                       waiting for a call.
  5510.  
  5511.        [F6]         : User's reason for wanting chat (if any).
  5512.  
  5513.        [F7]         : Interactive EMSI session information.
  5514.  
  5515.        [F9]         : Help! Hot-key summary.
  5516.  
  5517.        [F10]        : Turn off the status bar, to show exactly what
  5518.                       the  user is seeing.  [F1] to [F5] brings  it
  5519.                       back.
  5520.  
  5521.        [ALT-Fn]     : Activate  one of ten programs in a shell,  or
  5522.                       exit to DOS at a certain errorlevel.
  5523.  
  5524.        [ALT-C]      : Break  in for  a chat  if there is a user  on
  5525.                       remotely.  ESC  finishes chat mode and  drops
  5526.                       the user back to the BBS.
  5527.  
  5528.        [CTL-A]      : Opens  and  closes a  capture file  during  a
  5529.                       chat session.
  5530.  
  5531.        [ALT-D]      : Toggles  "Snoop" mode,  ie. whether the local
  5532.                       screen shows what the user is doing.
  5533.  
  5534.        [ALT-E]      : Activates a pop-up user attribute editor     
  5535.                       for the user currently online. 
  5536.  
  5537.        [ALT-H]      : Hang up on the user immediately.
  5538.  
  5539.        [ALT-J]      : Drop to a DOS shell while the user is  still 
  5540.                       on-line.
  5541.  
  5542.        [ALT-L]      : Lock  the  user out of the system by dropping
  5543.                       his/her  security level to zero  and  hanging
  5544.                       up.  
  5545.  
  5546.        [ALT-N]      : Toggle "sysop on next". When this mode is    
  5547.                       activated (indicated by [NS] on the F1 status
  5548.                       bar), RemoteAccess will pause and page the   
  5549.                       sysop for two minutes when the current user  
  5550.                       logs off. {+} Registered only.
  5551.  
  5552.                                     88
  5553.        [ALT-P]      : Toggle printer logging.
  5554.  
  5555.        [ALT-O]      : Override  paging  hours.  This allows you  to
  5556.                       enable or disable sysop paging regardless  of
  5557.                       the  time.  Note that this is permanent,  and
  5558.                       affects all lines until reset.
  5559.  
  5560.        [ALT-S]      : Modify the current user's security level.
  5561.  
  5562.        [Up-Arrow]   : Increase the user's time by one minute.
  5563.  
  5564.        [Down-Arrow] : Decrease the user's time by one minute.
  5565.  
  5566.  
  5567.  
  5568.        When  the system is waiting for a call,  the only sysop  key
  5569.        that is active is [ALT-O],  however, pressing [L] will allow
  5570.        you to log-on locally,  and [ESC] will terminate the program
  5571.        and  return to DOS.  Note that terminating in this way  will
  5572.        always  return  an  errorlevel  of 0 to  DOS  regardless  of
  5573.        whether the -E command-line parameter is invoked.
  5574.  
  5575.  
  5576.  
  5577.  
  5578.  
  5579.  
  5580.  
  5581.  
  5582.  
  5583.  
  5584.  
  5585.  
  5586.  
  5587.  
  5588.  
  5589.  
  5590.  
  5591.  
  5592.  
  5593.  
  5594.  
  5595.  
  5596.  
  5597.  
  5598.  
  5599.  
  5600.  
  5601.  
  5602.  
  5603.  
  5604.  
  5605.  
  5606.  
  5607.  
  5608.  
  5609.  
  5610.  
  5611.  
  5612.  
  5613.                                     89
  5614.        Command-line parameters 
  5615.        ────────────────────────────────────────────────────────────
  5616.  
  5617.        RemoteAccess accepts the following command-line parameters:
  5618.                     
  5619.        -NOEMS  : Forces RemoteAccess to ignore any available EMS.
  5620.  
  5621.        -Kpwd   : Lock the local keyboard with a password. The      
  5622.             {+}  password must be correctly entered prior to using 
  5623.                  any ALT-key.
  5624.  
  5625.        -L      : Run RemoteAccess in local mode.
  5626.        -S      : Set "snoop" mode off; disable local screen.
  5627.        -D      : Disable status bar by default.
  5628.        -R      : Log user back on-line after a menu type 15 exit.
  5629.  
  5630.        -G      : Used with the -R option; forces RemoteAccess to   
  5631.             {+}  return to the last menu the user was in at the    
  5632.                  time of the previous exit to DOS. The default is  
  5633.                  to return to the TOP menu.
  5634.  
  5635.        -P      : Log user activity to printer.
  5636.        -Nxx    : Line (node) number in a multi-line system (1-99).
  5637.        -Cx     : Communications port to use (1-4).
  5638.        -Bxxxxx : Log user on-line at baudrate xxxxx.
  5639.        -Exxx   : Exit at errorlevel xxx after caller logs off.
  5640.        -Txxx   : Time (in minutes) until next system event.
  5641.  
  5642.                  NOTE: Some mailers have the capability to generate
  5643.                  a "standard format" batch file called DOBBS.BAT to
  5644.                  run the BBS program. In shell-to-mailer mode (see 
  5645.                  below) RemoteAccess will scan this batch file (if 
  5646.                  present) to determine the time until the next     
  5647.                  event.
  5648.  
  5649.        -M<f>   : Activate  the "shell to  mailer"  feature.  This 
  5650.                  causes RemoteAccess, upon loading, to execute your
  5651.                  front-end mailer program in a DOS shell.  When the
  5652.                  mailer exits,  RemoteAccess detects the errorlevel
  5653.                  it  would normally pass to the batch-file.  If the
  5654.                  errorlevel  matches one defined in  RACONFIG,  the
  5655.                  user  is logged on to the BBS at  the  appropriate
  5656.                  baud rate.  If the errorlevel is not recognised as
  5657.                  an  incoming  call,  RemoteAccess   exits  to  its
  5658.                  batch-file at that errorlevel.  See the BATCH FILE
  5659.                  EXAMPLES section for more on this feature.
  5660.  
  5661.                  NOTE:  RemoteAccess  does  the swap by  storing  a
  5662.                  "swap  file"  in EMS (if available) and  on  disk.
  5663.                  Normally  this file would be stored in  the system
  5664.                  directory,   but   it   is   possible   to   force
  5665.                  RemoteAccess  to  put the file in a  directory  of
  5666.                  your  choice  by setting  the  RATEMP  environment
  5667.                  variable.  For  example,  if you executed the  DOS
  5668.                  command SET RATEMP=E:\TEMP\STORAGE,  then the swap
  5669.                  file   would  be  placed  in  the  E:\TEMP\STORAGE
  5670.                  directory.
  5671.  
  5672.  
  5673.  
  5674.                                     90
  5675.                  In "shell to mailer" mode,  it is possible for two
  5676.                  errorlevels to conflict. For example, errorlevel 5
  5677.                  is used by RA to indicate that a user entered both
  5678.                  net  and  echomail,  and by FrontDoor to  indicate
  5679.                  modem initialise failure. If the front-end returns
  5680.                  an   errorlevel  that  conflicts  in   this   way,
  5681.                  RemoteAccess  will  pass  to the batch  file  that
  5682.                  errorlevel  plus 10.  So,  if  FrontDoor  returned
  5683.                  errorlevel   5   because  the  modem   would   not
  5684.                  initialise,  RemoteAccess would pass errorlevel 15
  5685.                  to the batch file. 
  5686.  
  5687.  
  5688.  
  5689.  
  5690.  
  5691.  
  5692.  
  5693.  
  5694.  
  5695.  
  5696.  
  5697.  
  5698.  
  5699.  
  5700.  
  5701.  
  5702.  
  5703.  
  5704.  
  5705.  
  5706.  
  5707.  
  5708.  
  5709.  
  5710.  
  5711.  
  5712.  
  5713.  
  5714.  
  5715.  
  5716.  
  5717.  
  5718.  
  5719.  
  5720.  
  5721.  
  5722.  
  5723.  
  5724.  
  5725.  
  5726.  
  5727.  
  5728.  
  5729.  
  5730.  
  5731.  
  5732.  
  5733.  
  5734.  
  5735.                                     91
  5736.        Errorlevels                 
  5737.        ────────────────────────────────────────────────────────────
  5738.  
  5739.        When  RemoteAccess exits to DOS either after a user logs off
  5740.        or  because  of  a menu type 15 "Exit to  DOS"  function  it
  5741.        returns  an errorlevel that your batchfile should  test  for
  5742.        and act on accordingly:
  5743.  
  5744.        Errorlevel  Meaning
  5745.        ----------  -------
  5746.            0       User logged off OK,  default value.  Note - this
  5747.                    can  be  overridden  with the  -E  command  line
  5748.                    parameter. 
  5749.  
  5750.            1       Initialisation error - couldn't  find the FOSSIL
  5751.                    driver, or the modem failed to initialise.
  5752.  
  5753.            2       Special error condition;  used for Beta versions
  5754.                    only.
  5755.  
  5756.            3       The  user  entered one or more NetMail  messages
  5757.                    during the session.  The message base should  be
  5758.                    scanned for outgoing NetMail.
  5759.  
  5760.            4       The  user entered one or more EchoMail  messages
  5761.                    during  the session.  The message base should be
  5762.                    scanned for outgoing EchoMail.
  5763.  
  5764.            5       Both NetMail AND EchoMail messages were entered.
  5765.  
  5766.  
  5767.  
  5768.  
  5769.  
  5770.  
  5771.  
  5772.  
  5773.  
  5774.  
  5775.  
  5776.  
  5777.  
  5778.  
  5779.  
  5780.  
  5781.  
  5782.  
  5783.  
  5784.  
  5785.  
  5786.  
  5787.  
  5788.  
  5789.  
  5790.  
  5791.  
  5792.  
  5793.  
  5794.  
  5795.  
  5796.                                     92
  5797.        Text file control codes                                   
  5798.        ────────────────────────────────────────────────────────────
  5799.  
  5800.        There are a range of special control characters that can  be
  5801.        inserted  in any of your ASCII/ANSI files that cause certain
  5802.        system and user information to be displayed. There are three
  5803.        classes of codes.  Each code is a two-character  combination
  5804.        of a control-code followed by by a normal character:
  5805.  
  5806.                 Character
  5807.        ASCII#   Combination  Purpose
  5808.        ------   -----------  --------------------------------------
  5809.        01         ^A         Wait until the [Return] key is pressed
  5810.        02         ^B         Disable aborting with the "S" key
  5811.        03         ^C         Enable aborting with the "S" key
  5812.        04         ^D         Enable the "Continue?" prompt
  5813.        05         ^E         Disable the "Continue?" prompt
  5814.        06         ^F       * Insert a user parameter 
  5815.        07         ^G         Produce a beep on the caller's console
  5816.        08         ^H         Backspace
  5817.        09         ^I         Tab (forward 8 characters)
  5818.        10         ^J         Linefeed
  5819.        11         ^K       * Insert a system parameter
  5820.        12         ^L         Clear screen
  5821.        13         ^M         Carriage return
  5822.        17         ^Q         RESERVED FOR XON/XOFF HANDSHAKING
  5823.        19         ^S         RESERVED FOR XON/XOFF HANDSHAKING
  5824.        22         ^V         RESERVED FOR AVATAR
  5825.        23         ^W         Pause for one second
  5826.        24         ^X       * Execute a program in a DOS shell
  5827.        26         ^Z         END OF FILE MARKER. DON'T USE THIS!
  5828.  
  5829.        EXECUTING A PROGRAM IN A DOS SHELL:
  5830.        This  gives you the ability to run an external program in  a
  5831.        DOS  shell whenever RemoteAccess encounters a ^X embedded in
  5832.        a text file. The ^X is followed by the command line you want
  5833.        to  execute,  and terminated with the pipe symbol  (|).  For
  5834.        example,  to  run an external mail checking utility  when  a
  5835.        user  logs  on  you could embed the following entry  in  the
  5836.        WELCOME.A?? file:
  5837.  
  5838.             ^X\RA\MAILCHEK.EXE *B *F *L|
  5839.  
  5840.        RemoteAccess would then execute the following DOS command:
  5841.  
  5842.             \RA\MAILCHEK.EXE 2400 FirstName LastName
  5843.  
  5844.        Note  that  you  MUST terminate the command  with  the  pipe
  5845.        symbol.  All special DOS shell control codes may be used  as
  5846.        per the type 7 menu function.
  5847.  
  5848.        BEWARE!  Use this feature with caution.  Imagine the  damage
  5849.        that this embedded command could do:
  5850.  
  5851.             COPY \RA\USERS.BBS \RA\FILES\IBM\NEWFILES
  5852.  
  5853.  
  5854.  
  5855.  
  5856.  
  5857.                                     93
  5858.        If  there is any possibility of a user being able to  modify
  5859.        any  of  the  text files that  your  system  displays,  then
  5860.        disable  the shell feature by using the option in  RACONFIG.
  5861.        "Note to next user"  programs are notorious for this! If you
  5862.        don't  think it ever happens, then maybe this will  convince
  5863.        you.  A local sysop was watching his board one afternoon and
  5864.        noticed  that when a user logged off,  he got the  following
  5865.        message:
  5866.  
  5867.  
  5868.        "Hey,  Joe!  What  sort of a password is ROCKET?  Next  time
  5869.        choose a harder one!!    ... Fred"
  5870.  
  5871.        The  sysop  couldn't believe his eyes.  How could this  have
  5872.        happened?  Well,  the  "note  to next user" utility  he  had
  5873.        installed  a  few weeks earlier was to  blame.  It  actually
  5874.        allowed a user upload a short text file that was appended to
  5875.        the  GOODBYE disconnect file.  "Fred" had simply inserted  a
  5876.        few control characters into the file that would display  the
  5877.        current  user's  first name and password,  which  of  course
  5878.        would  always  be correct for whoever viewed  it.  Well,  it
  5879.        shook that sysop up a bit, as well as teaching him a lesson.
  5880.  
  5881.        Luckily  the ^X feature wasn't enabled,  or  anything  could
  5882.        have happened...
  5883.  
  5884.  
  5885.  
  5886.  
  5887.  
  5888.  
  5889.  
  5890.  
  5891.  
  5892.  
  5893.  
  5894.  
  5895.  
  5896.  
  5897.  
  5898.  
  5899.  
  5900.  
  5901.  
  5902.  
  5903.  
  5904.  
  5905.  
  5906.  
  5907.  
  5908.  
  5909.  
  5910.  
  5911.  
  5912.  
  5913.  
  5914.  
  5915.  
  5916.  
  5917.  
  5918.                                     94
  5919.        * User Parameter Codes
  5920.        ----------------------
  5921.  
  5922.                Character
  5923.        ASCII#  Combination  Information displayed
  5924.        ------  -----------  ---------------------------------------
  5925.        65        ^FA        Users full name
  5926.        66        ^FB        Location
  5927.        67        ^FC        Password
  5928.        68        ^FD        Business/Data phone number
  5929.        69        ^FE        Voice/Home phone number
  5930.        70        ^FF        Date of last call
  5931.        71        ^FG        Time of last call
  5932.        72        ^FH        A Flags setting
  5933.        73        ^FI        B Flags setting
  5934.        74        ^FJ        C Flags setting
  5935.        75        ^FK        D Flags setting
  5936.        76        ^FL        NetMail credit remaining (cents)
  5937.        77        ^FM        Total messages posted
  5938.        78        ^FN        Last message read
  5939.        79        ^FO        Security level
  5940.        80        ^FP        Total calls to the BBS
  5941.        81        ^FQ        Number of uploads
  5942.        82        ^FR        Kilobytes of uploads
  5943.        83        ^FS        Number of downloads
  5944.        84        ^FT        Kilobytes of downloads
  5945.        85        ^FU        Minutes used today
  5946.        86        ^FV        Current screen length
  5947.        87        ^FW        First name only
  5948.        88        ^FX        ANSI setting (ON/OFF)
  5949.        89        ^FY        "Continue?" prompt setting (ON/OFF)
  5950.        90        ^FZ        Screen clearing (ON/OFF)
  5951.        48        ^F0        Full screen editor (ON/OFF)
  5952.        49        ^F1        Quiet/do not disturb mode (ON/OFF)
  5953.        50        ^F2        Hot-Keys (ON/OFF)
  5954.        51        ^F3        Handle
  5955.        52        ^F4        Date of first call
  5956.        53        ^F5        Date of birth
  5957.        54        ^F6        Subscription expiry date
  5958.        55        ^F7        Days until subscription expiry
  5959.        56        ^F8        AVATAR setting (ON/OFF)
  5960.        57        ^F9        File ratio (number of files)
  5961.        58        ^F:        File ratio (kilobytes)
  5962.        59        ^F;        Full screen message viewer (ON/OFF)
  5963.  
  5964.  
  5965.  
  5966.  
  5967.  
  5968.  
  5969.  
  5970.  
  5971.  
  5972.  
  5973.  
  5974.  
  5975.  
  5976.  
  5977.  
  5978.  
  5979.                                     95
  5980.        * System Parameter Codes
  5981.        ------------------------
  5982.  
  5983.                Character
  5984.        ASCII#  Combination  Information displayed
  5985.        ------  -----------  ---------------------------------------
  5986.        65        ^KA        Total system calls
  5987.        66        ^KB        Last caller (any line)
  5988.        67        ^KC        Number of active messages
  5989.        68        ^KD        System starting message number
  5990.        69        ^KE        System ending message number
  5991.        70        ^KF        Number of times user has paged sysop
  5992.        71        ^KG        Day of the week (full form)
  5993.        72        ^KH        Number of users in the user file
  5994.        73        ^KI        Time in 24 hour format
  5995.        74        ^KJ        Today's date
  5996.        75        ^KK        Minutes connected this call
  5997.        76        ^KL        Seconds connected (always returns 0)
  5998.        77        ^KM        Minutes used today
  5999.        78        ^KN        Seconds used today (always returns 0)
  6000.        79        ^KO        Minutes remaining today
  6001.        80        ^KP        Seconds remaining today (always 0)
  6002.        81        ^KQ        Daily time limit
  6003.        82        ^KR        Current baud rate
  6004.        83        ^KS        Day of the week (abbreviated form)
  6005.        84        ^KT        Daily download limit (in K)
  6006.        85        ^KU        Minutes until next system event
  6007.        86        ^KV        24 hour format time of the next event
  6008.        87        ^KW        Line number (as set on command line)
  6009.        88        ^KX        TERMINATES THE CALL
  6010.        89        ^KY        Name of current template message area
  6011.        90        ^KZ        Name of current template file area
  6012.        48        ^K0        Number of msgs in selected msg area
  6013.        49        ^K1        Number of current template message area
  6014.        50        ^K2        Number of current template file area
  6015.  
  6016.  
  6017.  
  6018.  
  6019.  
  6020.  
  6021.  
  6022.  
  6023.  
  6024.  
  6025.  
  6026.  
  6027.  
  6028.  
  6029.  
  6030.  
  6031.                     
  6032.  
  6033.  
  6034.  
  6035.  
  6036.  
  6037.  
  6038.  
  6039.  
  6040.                                     96
  6041.        Modem string translation
  6042.        ────────────────────────────────────────────────────────────
  6043.  
  6044.        RemoteAccess recognizes certain characters embedded in  your
  6045.        modem  initialise  strings,  and  converts them  to  special
  6046.        functions. The supported characters are:
  6047.  
  6048.        ^  Raise DTR, modem will answer the phone.
  6049.  
  6050.        v  Lower DTR, disconnect if connected.
  6051.  
  6052.        ~  Wait for 1/4 of a second before continuing
  6053.  
  6054.        |  Send a carriage-return [CR] to the modem
  6055.  
  6056.  
  6057.  
  6058.  
  6059.  
  6060.  
  6061.  
  6062.  
  6063.  
  6064.  
  6065.  
  6066.  
  6067.  
  6068.  
  6069.  
  6070.  
  6071.  
  6072.  
  6073.  
  6074.  
  6075.  
  6076.  
  6077.  
  6078.  
  6079.  
  6080.  
  6081.  
  6082.  
  6083.  
  6084.  
  6085.  
  6086.  
  6087.  
  6088.  
  6089.  
  6090.  
  6091.  
  6092.  
  6093.  
  6094.  
  6095.  
  6096.  
  6097.  
  6098.  
  6099.  
  6100.  
  6101.                                     97
  6102.        Questionnaire script language
  6103.        ────────────────────────────────────────────────────────────
  6104.  
  6105.        Questionnaire   script  files  are  stored  in  the   system
  6106.        directory  and have the extension .Q-A.  Each file is  plain
  6107.        ASCII,  and  contains one command per  line.  The  available
  6108.        commands are listed below. Note that the command interpreter
  6109.        is case-insensitive,  so the command "Ask" could be  entered
  6110.        as "ASK" or "ask". 
  6111.  
  6112.  
  6113.  
  6114.  
  6115.  
  6116.  
  6117.  
  6118.  
  6119.  
  6120.  
  6121.  
  6122.  
  6123.  
  6124.  
  6125.  
  6126.  
  6127.  
  6128.  
  6129.  
  6130.  
  6131.  
  6132.  
  6133.  
  6134.  
  6135.  
  6136.  
  6137.  
  6138.  
  6139.  
  6140.  
  6141.  
  6142.  
  6143.  
  6144.  
  6145.  
  6146.  
  6147.  
  6148.  
  6149.  
  6150.  
  6151.  
  6152.  
  6153.  
  6154.  
  6155.  
  6156.  
  6157.  
  6158.  
  6159.  
  6160.  
  6161.  
  6162.                                     98
  6163.        Ask <Len> <Var num>
  6164.        -------------------
  6165.  
  6166.             Example : Ask 15 3
  6167.  
  6168.        Waits  for  the  user  to input a string that is  up  to  15
  6169.        characters long,  and stores the string in the variable <Var
  6170.        num>.  Valid values for <Len> are 1 to 255. <Var num> may be
  6171.        any number between 1 and 20.
  6172.  
  6173.  
  6174.  
  6175.        Capitalise <ON|OFF>
  6176.        -------------------
  6177.  
  6178.             Example : Capitalise ON
  6179.  
  6180.        Turns on or off auto-input prompt capitalisation.
  6181.  
  6182.  
  6183.  
  6184.        ChangeColor <Foreground> <Background>
  6185.        -------------------------------------
  6186.  
  6187.             Example : ChangeColor 7 1
  6188.  
  6189.        Changes the colour of the text if the user has ANSI graphics
  6190.        enabled. Valid colours are:
  6191.  
  6192.             <Foreground>                        <Background>
  6193.             ------------                        ------------
  6194.  
  6195.             0    Black                          0   Black
  6196.             1    Blue                           1   Blue
  6197.             2    Green                          2   Green
  6198.             3    Cyan                           3   Cyan
  6199.             4    Red                            4   Red
  6200.             5    Magenta                        5   Magenta
  6201.             6    Brown                          6   Brown
  6202.             7    Light Grey                     7   Light Grey
  6203.             8    Dark Grey
  6204.             9    Light Blue
  6205.            10    Light Green
  6206.            11    Light Cyan
  6207.            12    Light Red
  6208.            13    Light Magenta
  6209.            14    Yellow
  6210.            15    White
  6211.  
  6212.  
  6213.  
  6214.        ClearScreen
  6215.        -----------
  6216.  
  6217.             Example : ClearScreen
  6218.  
  6219.        Clears  the  user's  screen if  he/she  has  enabled  screen
  6220.        clearing.
  6221.  
  6222.  
  6223.                                     99
  6224.        Display "<Text>"
  6225.        ----------------
  6226.  
  6227.             Example : Display "Please answer ALL questions|"
  6228.  
  6229.        Displays the specified text on the screen.  The vertical bar
  6230.        is  translated to a line-feed and carriage return.  If  this
  6231.        bar  is  ommitted,  any  following text starts at  the  next
  6232.        character on the same line.
  6233.  
  6234.  
  6235.  
  6236.        DisplayFile <1-8 character file name>
  6237.        -------------------------------------
  6238.  
  6239.             Example : DisplayFile BBSRULES
  6240.  
  6241.        Causes a text file to be displayed in the same way as a menu
  6242.        type 5 would be displayed. The text file must be in the text
  6243.        file directory, and have the extension .ASC/.ANS.
  6244.  
  6245.  
  6246.  
  6247.        EndIf
  6248.        -----
  6249.         
  6250.             Example : EndIf
  6251.  
  6252.        Signifies the end of an IF statement.
  6253.  
  6254.  
  6255.  
  6256.        If <Var num> = "<String>"
  6257.        -------------------------
  6258.  
  6259.             Example : If 5 = "Perth"
  6260.  
  6261.        The  IF  command  compares the  contents  of  the  specified
  6262.        variable number with <String>. If the two do not match, then
  6263.        all following lines are skipped until an ENDIF statement  is
  6264.        encountered.
  6265.  
  6266.  
  6267.  
  6268.        Exec <commandline>
  6269.        ------------------
  6270.  
  6271.             Example : Exec C:\RA\NEWMAIL.EXE *B
  6272.  
  6273.        Executes  a  program  in   a  DOS  shell.  All  command-line
  6274.        parameters valid in a menu type 7 command may be used.
  6275.  
  6276.  
  6277.  
  6278.  
  6279.  
  6280.  
  6281.  
  6282.  
  6283.  
  6284.                                     100
  6285.        GetChoice <Valid choices> <Var num>
  6286.        -----------------------------------
  6287.  
  6288.             Example : GetChoice YN 2
  6289.  
  6290.        Waits  for the user to enter one of the characters in <Valid
  6291.        choices>, and stores the response in the variable <Var num>.
  6292.  
  6293.  
  6294.  
  6295.        ListAnswer <Var num>
  6296.        --------------------
  6297.  
  6298.             Example : ListAnswer 5
  6299.  
  6300.        Displays  (to the screen) the contents of the variable  <Var
  6301.        num> followed by a CR/LF.
  6302.  
  6303.  
  6304.  
  6305.        MenuCmnd <Num> <Data>
  6306.        ---------------------
  6307.  
  6308.             Example : MenuCmnd 27 60 /T=Andrew_Milner
  6309.  
  6310.        Executes a  menu command. Simply specify  the command number
  6311.        followed by  the contents of  the optional data  field. Note
  6312.        that menu navigation commands  (GOTO, GOSUB, RETURN etc) may
  6313.        not be used.
  6314.  
  6315.  
  6316.  
  6317.        OutputAnswer "<Descriptor>" <Var num>
  6318.        -------------------------------------
  6319.  
  6320.             Example : OutputAnswer "Hobbies  : " 6
  6321.  
  6322.        Outputs  <Descriptor>  followed  by  the  contents  of   the
  6323.        variable  <Var  num> to the questionnaire answer  file.  The
  6324.        answer file is given the same name as the questionnaire file
  6325.        but has an extension of .ASW.
  6326.  
  6327.  
  6328.  
  6329.        PostInfo
  6330.        --------
  6331.  
  6332.             Example : PostInfo
  6333.  
  6334.        Outputs  the user's name and some other information  to  the
  6335.        answer file.
  6336.  
  6337.  
  6338.  
  6339.  
  6340.  
  6341.  
  6342.  
  6343.  
  6344.  
  6345.                                     101
  6346.        Quit
  6347.        ----
  6348.  
  6349.             Example : Quit
  6350.  
  6351.        Terminates the questionnaire and returns to the BBS.
  6352.  
  6353.  
  6354.  
  6355.        SetFlag <Flag set><Flag number> <ON|OFF>
  6356.        ----------------------------------------
  6357.  
  6358.             Example : SetFlag C3 OFF
  6359.  
  6360.        Turns on or off the specified user flag.  <Flag set> is "A",
  6361.        "B",  "C" or "D",  and <Flag number> is a number between one
  6362.        and eight.
  6363.  
  6364.  
  6365.  
  6366.        SetSecurity <Security level>
  6367.        ----------------------------
  6368.  
  6369.             Example : SetSecurity 10
  6370.  
  6371.        Simply   sets  the  user's  security  level  to  the  number
  6372.        specified. The level may be any number from 1 to 64,000.
  6373.  
  6374.  
  6375.  
  6376.        WaitEnter
  6377.        ---------
  6378.  
  6379.             Example : WaitEnter
  6380.  
  6381.        Waits for the user to press [ENTER].
  6382.  
  6383.  
  6384.  
  6385.  
  6386.  
  6387.  
  6388.  
  6389.  
  6390.  
  6391.  
  6392.  
  6393.  
  6394.  
  6395.  
  6396.  
  6397.  
  6398.  
  6399.  
  6400.  
  6401.  
  6402.  
  6403.  
  6404.  
  6405.  
  6406.                                     102
  6407.        Terminal emulations
  6408.        ────────────────────────────────────────────────────────────
  6409.  
  6410.        A terminal emulation is the method that RemoteAccess uses to
  6411.        communicate  with the  user's  software. The  most basic  of
  6412.        these is  straight ASCII.  The ASCII terminal  emulation can
  6413.        only display normally visible  characters plus a few others,
  6414.        such as backspace, linefeed and clearscreen.
  6415.  
  6416.        RemoteAccess supports two  additional emulations -  ANSI and
  6417.        AVATAR.  ANSI  is   currently  the  most  popular   terminal
  6418.        emulation in the bulletin board world; it has the capability
  6419.        to change text  colour, cursor position,  and can do  simple
  6420.        animations.  Some  implementations  of ANSI  can  even  play
  6421.        simple  tunes  at  the  user's  end.  ANSI  does  have  some
  6422.        drawbacks; each  special control code is  several characters
  6423.        long. To  change the  text colour  for  example, requires  a
  6424.        control  code of up to 8 characters. These lengthy codes can
  6425.        severely slow the  user's display, and  for this reason  the
  6426.        usefulness  of  ANSI at  speeds of  1200  baud and  lower is
  6427.        limited.
  6428.  
  6429.        AVATAR,  on the  other  hand, uses  control  codes that  are
  6430.        typically a quarter to  a third of the length  of their ANSI
  6431.        equivalents,  making it  usable  at lower  speeds. Not  only
  6432.        that,  but AVATAR  has  much more  advanced screen  control,
  6433.        making possible  relatively  complex animations  and  screen
  6434.        displays. AVATAR is a newcomer - there are comparatively few
  6435.        terminal programs  that support it, even  fewer that support
  6436.        it properly.  At  this  time  there  are  no  utilities  for
  6437.        creating AVATAR  screens. You can however  convert your ANSI
  6438.        screens to AVATAR with the supplied utility.
  6439.  
  6440.        RemoteAccess  uses  AVATAR  level  0+  (AVT/0+).   The  only
  6441.        terminal programs  which have been tested  successfully with
  6442.        AVT/0+   are  Joaquim  Homrighausen's   FrontDoor  and  Adam
  6443.        Stanislav's TinyTerm. If you  make use of AVT/0+  you should
  6444.        make it clear to your users that they should be using one of
  6445.        these  two,  until more  terminal programs  implement AVATAR
  6446.        support.
  6447.  
  6448.  
  6449.  
  6450.  
  6451.  
  6452.  
  6453.  
  6454.  
  6455.  
  6456.  
  6457.  
  6458.  
  6459.  
  6460.  
  6461.  
  6462.  
  6463.  
  6464.  
  6465.  
  6466.  
  6467.                                     103
  6468.        Text file naming conventions
  6469.        ────────────────────────────────────────────────────────────
  6470.  
  6471.        RemoteAccess displays  text files at specific  points and in
  6472.        response  to  specific  events. The  EXTERNAL  SUPPORT FILES
  6473.        section  details all these  text files. Files  that have the
  6474.        .A??  extension  may  be  displayed  in  any  one  of  three
  6475.        "flavours":
  6476.  
  6477.        .ASC : ASCII only, no special control codes
  6478.        .ANS : ANSI, should only contain text and ANSI codes
  6479.        .AVT : AVATAR, may contain text and AVATAR codes.
  6480.  
  6481.        If a  user has  both ANSI  and AVATAR  enabled, RemoteAccess
  6482.        will  search first for a .AVT file, and if unsuccessful will
  6483.        then try .ANS  and then .ASC.  If only  ANSI *or* AVATAR  is
  6484.        selected and  the preferred  file type isn't  available, the
  6485.        .ASC version will be displayed.
  6486.  
  6487.  
  6488.  
  6489.  
  6490.  
  6491.  
  6492.  
  6493.  
  6494.  
  6495.  
  6496.  
  6497.  
  6498.  
  6499.  
  6500.  
  6501.  
  6502.  
  6503.  
  6504.  
  6505.  
  6506.  
  6507.  
  6508.  
  6509.  
  6510.  
  6511.  
  6512.  
  6513.  
  6514.  
  6515.  
  6516.  
  6517.  
  6518.  
  6519.  
  6520.  
  6521.  
  6522.  
  6523.  
  6524.  
  6525.  
  6526.  
  6527.  
  6528.                                     104
  6529.        Interactive EMSI
  6530.        ────────────────────────────────────────────────────────────
  6531.  
  6532.        Interactive  EMSI (IEMSI) is a protocol which can be used by
  6533.        communications software to  establish certain parameters for
  6534.        an interactive session, for  example a user logging on  to a
  6535.        bulletin board.  The only software to support  IEMSI at this
  6536.        time is RemoteAccess 1.00 and FrontDoor 2.01.
  6537.  
  6538.        From within the FrontDoor setup program, the user can define
  6539.        a number of user  "profiles", each of which includes  a user
  6540.        name, handle, password, telephone number, location etc. When
  6541.        IEMSI is enabled from within the terminal and the user calls
  6542.        a RemoteAccess  BBS, the user's  information is sent  to the
  6543.        BBS automatically.
  6544.  
  6545.        This  makes it possible for a  user (the "client") to log on
  6546.        to a BBS (the "server")  without even touching the keyboard.
  6547.        FrontDoor  and  RemoteAccess  will   automatically  exchange
  6548.        information such as software name and version number, screen
  6549.        parameters and local time.
  6550.  
  6551.        One  useful  feature  is  the   ability  of  the  server  to
  6552.        temporarily modify  the user's  display  parameters for  the
  6553.        current  session only.  For  example, normally  when a  user
  6554.        calls  a particular  BBS  he/she  might  use  25  line  mode
  6555.        locally, so  the "screenlength"  field in his/her  record is
  6556.        set  to  25 accordingly.  However,  on  one occasion  he/she
  6557.        activates   the  FrontDoor   terminal   in  50   line  mode.
  6558.        RemoteAccess will  recognise this and set  the screen length
  6559.        to 50 for the  current session only, restoring it to 25 when
  6560.        the  user   disconnects.  In  addition,   RemoteAccess  will
  6561.        automatically activate whatever terminal emulations  both it
  6562.        and the client supports.
  6563.  
  6564.        To  see if a  user is connected  in IEMSI mode  to your BBS,
  6565.        press F7. If IEMSI is active,  RemoteAccess will display the
  6566.        relevant information about the client's system on the status
  6567.        bar. At  the right hand  end of  the status  bar the  user's
  6568.        request flags  are displayed.  A request  flag is an  option
  6569.        that the  user  asked for.  RemoteAccess currently  supports
  6570.        these request flags:
  6571.  
  6572.             CLR : Clear screen codes
  6573.            NEWS : Display the NEWS.A?? file
  6574.            MAIL : Check for new mail
  6575.            FILE : Check for new files
  6576.             HOT : Use hot-keys
  6577.            HUSH : Activate "do not disturb"
  6578.            FSED : Use the full screen message editor
  6579.  
  6580.  
  6581.  
  6582.  
  6583.  
  6584.  
  6585.  
  6586.  
  6587.  
  6588.  
  6589.                                     105
  6590.        BATCH FILE EXAMPLES       
  6591.        ────────────────────────────────────────────────────────────
  6592.  
  6593.        These examples are not usable in their presented form.  They
  6594.        are provided as a starting point for your own batch files:
  6595.  
  6596.  
  6597.        Using RemoteAccess stand-alone (ie. without a mailer)
  6598.        -----------------------------------------------------
  6599.  
  6600.        :START
  6601.           Cd \RA
  6602.  
  6603.           REM Run the main program:
  6604.           RA -E20
  6605.  
  6606.           REM User logged off, cycle back:
  6607.           if errorlevel 20 goto START
  6608.  
  6609.           REM RemoteAccess exits to the batchfile with errorlevel 7
  6610.           REM once a night:
  6611.           
  6612.           if errorlevel  7 goto CLEAN
  6613.  
  6614.           if errorlevel  3 goto START
  6615.  
  6616.           REM An errorlevel of 1 or 2 means a fatal error, an
  6617.           REM errorlevel of 0 means that ESCape was pressed while
  6618.           REM in "wait for call" mode - so we quit:  
  6619.           goto END
  6620.  
  6621.        :CLEAN
  6622.           REM Do nightly message and user maintenance with RAUSER 
  6623.           and RAMSG
  6624.           goto START
  6625.  
  6626.        :END
  6627.           echo RemoteAccess HQ Line 1 Down.
  6628.  
  6629.  
  6630.        NOTE  :  Unlike some other BBS packages,  RemoteAccess  will
  6631.        ALWAYS exit back to DOS (or your batch file) after a  caller
  6632.        logs  off.  This means that you can only run in  stand-alone
  6633.        mode with a batch file that will recycle back to restart the
  6634.        main program.
  6635.  
  6636.  
  6637.  
  6638.  
  6639.  
  6640.  
  6641.  
  6642.  
  6643.  
  6644.  
  6645.  
  6646.  
  6647.  
  6648.  
  6649.  
  6650.                                     106
  6651.        Using RemoteAccess with a mailer (FrontDoor or BinkleyTerm)
  6652.        (using either TosScan or Echogen to process mail)
  6653.        -------------------------------------------------
  6654.  
  6655.        :START 
  6656.           cd \RA
  6657.  
  6658.           REM Run the main program and run the mailer in a "shell".
  6659.           REM The *M tells RemoteAccess to swap out of memory 
  6660.           REM before running the mailer.
  6661.  
  6662.           REM Either FrontDoor : RA -m\FD\FD.EXE*M -E20
  6663.           REM   or BinkleyTerm : RA -m\BT\BT.EXE*M -E20
  6664.  
  6665.           REM Any errorlevels that RemoteAccess does not understand
  6666.           REM it passes back to the batchfile:
  6667.  
  6668.           if errorlevel 150 goto CLEAN
  6669.           if errorlevel  99 goto UNPACK
  6670.           if errorlevel  20 goto START
  6671.           if errorlevel  10 goto END
  6672.           if errorlevel   5 goto NET&ECHO
  6673.           if errorlevel   4 goto ECHO
  6674.           if errorlevel   3 goto NET
  6675.           goto END
  6676.  
  6677.        :CLEAN
  6678.           REM Do your nightly maintenance here. In this example
  6679.           REM the mailer is set to exit at errorlevel 150 nightly.
  6680.  
  6681.        :UNPACK
  6682.           REM Toss incoming mail
  6683.           REM Either : TOSSCAN toss
  6684.           REM     or : ECHOGEN -A -P -T -U
  6685.           goto START
  6686.  
  6687.        :NET&ECHO
  6688.           REM Net and EchoMail needs to be exported from the 
  6689.           REM message base.
  6690.           REM Either : TSUTIL export
  6691.           REM     or : MAILSCAN
  6692.  
  6693.        :ECHO
  6694.           REM Export EchoMail.
  6695.           REM Either : TOSSCAN scan
  6696.           REM     or : ECHOGEN -A -E -P
  6697.           goto START
  6698.  
  6699.        :NET
  6700.           REM Only export NetMail
  6701.           REM Either : TSUTIL export
  6702.           REM     or : MAILSCAN
  6703.           goto START
  6704.                 
  6705.  
  6706.        :END
  6707.           REM Some fatal error occurred.
  6708.           echo RemoteAccess HQ Line 2 Down.
  6709.  
  6710.  
  6711.                                     107
  6712.        * The Echogen command-line switches shown assume a FrontDoor
  6713.          environment.
  6714.  
  6715.           Note that the particular command-line switches for all of
  6716.        these      utilities  (BinkleyTerm,  FrontDoor,  TosScan  or
  6717.        Echogen)  will vary according to your set up.  All of  these
  6718.        programs are supplied with documentation which will  provide
  6719.        you  with this information.  It is stressed again that these
  6720.        examples are only intended to give you a starting point  for
  6721.        creating your own batch files.
  6722.  
  6723.  
  6724.  
  6725.  
  6726.  
  6727.  
  6728.  
  6729.  
  6730.  
  6731.  
  6732.  
  6733.  
  6734.  
  6735.  
  6736.  
  6737.  
  6738.  
  6739.  
  6740.  
  6741.  
  6742.  
  6743.  
  6744.  
  6745.  
  6746.  
  6747.  
  6748.  
  6749.  
  6750.  
  6751.  
  6752.  
  6753.  
  6754.  
  6755.  
  6756.  
  6757.  
  6758.  
  6759.  
  6760.  
  6761.  
  6762.  
  6763.  
  6764.  
  6765.  
  6766.  
  6767.  
  6768.  
  6769.  
  6770.  
  6771.  
  6772.                                     108
  6773.